Mailocator API je určeno pro integraci do nástrojů pomocí RESTful rozhraní
Pomocí API získáte
- sumarizaci měsíčních souhrnů pro účtování v externích systémech
- statistické informace o jednotlivých projektech
- možnost exportu dat z datového úložiště
- rozhraní pro import externích auditorií (podporováno vybraným ESP, např. Targito)
API klíč
Postup pro vytvoření API klíče:
otevřete projekt Mailocatoru
přejděte do Nastavení projektu
V oddílu Expertní vyberte kartu Mailocator API a postupujte podle instrukcí
Endpoint a struktura dotazu
Endpoint má vždy tuto strukturu, parametrů může být více
https://api.mailocator.com/[ version ]/[ method ]/[ parameter ]/[ content-type ]
Autorizace
Do HTTP požadavku vložte následující hlavičku, kde API klíč musí být base64-encoded:
Authorization: Basic VGhpcyBpcyBteSBhcGkga2V5
Příklad požadavku
curl -X GET "https://api.mailocator.com/2.0/ping/time/JSON" \
-H "Authorization: Basic VGhpcyBpcyBteSBhcGkga2V5" Výsledek
HTTP/1.1 200 OK
{"status":1, "error":0, "mesg":"Request successful", "timestamp":1595621265} Chyba
HTTP/1.1 401 Unauthorized
{"status":0, "error":true, "mesg":"Authorization failed: Invalid API key!"} Testovací prostředí
Pokud máte platný klíč, můžete použít testovací prostředí na adrese https://api.mailocator.com/test/