Autentimine
Saada töölaual väljastatud piiratud srs_live_ võti Bearer-tokenina. Igal võtmel on oma scope’id (emails:send, webhooks:write …); tühistatud või aegunud võtmed lükatakse tagasi koodiga 401.
POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json
{
"from": "Sender Name <info@example.com>",
"to": ["user@example.net"],
"subject": "Reset your password",
"html": "<p>Click to reset your password.</p>"
}Põhiressursid
- POST /v1/emails — lisa üks sõnum järjekorda
- POST /v1/emails/batch — kuni 100 sõnumit ühe päringuga
- GET /v1/emails — viimaste sõnumite loend
- GET /v1/emails/{id} — sõnumi olek
- DELETE /v1/emails/{id}/schedule — tühista ajastatud saatmine
Vastuse mudel
202 tähendab, et sõnum on järjekorda lisatud, mitte postkasti toimetatud. 403 võib viidata puuduvale õiguste ulatusele või kinnitamata domeenile. 422 blokeerib mahasurutud (suppressed) saaja. 429 tähistab kiiruspiirangut (rate limiting).
Teenuse praegused piirangud
REST API ei toeta manuseid. Lubatud kohandatud päised on ainult In-Reply-To, References, List-Unsubscribe ja List-Unsubscribe-Post (kuni 8). Majutatud post on eraldi: veebiklient lubab 20 manust, kokku 25 MiB; avaldatud töölauakliendi saatmispiir on 10 MiB. HTTP 202 ja email.accepted tähendavad töötlemiseks vastuvõtmist; SMTP vastuvõtt ei taga kohaletoimetamist ega postkasti jõudmist.