API
Nisja e shpejtë
Një çelës dhe një dërgim i parë.
1. Krijoni një çelës
- Hapni Cilësimet → Çelësat API. Faqja është aty vetëm nëse jeni ju pronari i kutisë postare.
- Emërtojeni sipas asaj që do ta përdorë. Ai emër është mënyra si e gjeni sërish kur diçka duhet revokuar.
- Zgjidhni fushëveprimet e tij. Si parazgjedhje, vetëm dërgim.
- Sipas dëshirës, ngushtoni atë me çfarë mund të dërgojë: domene të tëra, adresa të veçanta, ose të dyja. Një domen i tërë mbulon edhe adresat që i shtohen më vonë.
- Kopjojeni çelësin. Shfaqet një herë të vetme dhe nuk rikuperohet: ajo që ruhet është një hash i njëanshëm. Rrotullimi i çelësit më vonë e shfaq zëvendësuesin një herë, në të njëjtën mënyrë.
2. Dërgoni diçka
npm install @openemail/sdkOpsionale. Çdo endpoint është HTTP dhe JSON i thjeshtë, dhe skeda curl më poshtë nuk kërkon asgjë të instaluar.
curl -X POST https://api.openemail.uk/emails \ -H "Authorization: Bearer $OPENEMAIL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "Acme Billing <[email protected]>", "to": ["[email protected]"], "subject": "Your September invoice", "html": "<p>Invoice attached.</p>" }'Një 200 do të thotë se ai ka ikur. Merrni prapa një id. Ruajeni: është mënyra si e merrni mesazhin, si lexoni gjurmën e ngjarjeve të tij, ose si e anuloni nëse e planifikuat.
Po merrni një 403 që nuk e prisnit? GET /addresses liston pikërisht se me çfarë mund të dërgojë ky çelës. Pothuajse gjithmonë është fushëveprimi i dërgimit te çelësi, një domen ose një adresë që nuk iu dha, e jo një domen që mungon te hapësira e punës.