Začínáme
API Reference
Kompletní reference pro všechny Emailit API v2 endpointy, formáty požadavků a schémata odpovědí.
Základní URL
Všechny API požadavky by měly být směřovány na následující základní URL. Podporujeme pouze zabezpečené HTTPS požadavky.
Naše aktuální verze API je v2 s následující základní URL:
Autentizace
Emailit API v2 používá API klíče pro autentizaci požadavků. Své API klíče můžete zobrazit a spravovat v Emailit Dashboard.
Vaše API klíče mají rozsáhlá oprávnění, proto je bezpečně uchovávejte! Nesdílejte své tajné API klíče na veřejně přístupných místech, jako je GitHub, klientský kód a podobně.
Omezení rychlosti
Naše API v2 a SMTP má počáteční limit rychlosti 2 zprávy za sekundu pro nové pracovní prostory. Vyšší limit rychlosti si můžete vždy vyžádat v Emailit Dashboard.
Každý pracovní prostor má také počáteční limit 5000 zpráv za den.
Kódy odpovědí
API používá konvenční HTTP kódy odpovědí k označení úspěchu nebo selhání.
| Stavový kód | Popis |
|---|---|
| 200 | OK - Požadavek byl úspěšný |
| 400 | Chybný požadavek - Neplatné parametry požadavku |
| 401 | Neautorizováno - Neplatný nebo chybějící API klíč |
| 403 | Zakázáno - Přístup k požadovanému zdroji byl odepřen |
| 404 | Nenalezeno - Požadovaný zdroj neexistuje |
| 429 | Příliš mnoho požadavků - Překročen limit rychlosti |
| 500 | Interní chyba serveru - Na naší straně se něco pokazilo |