EvilMail API-ге кіріспе
EvilMail API RESTful архитектурасына негізделген және JSON форматында жауап қайтарады. API арқылы пошта жәшіктерін жасау, хаттарды оқу, жіберу және басқару мүмкін.
Аутентификация
API-ге кіру үшін сізге API кілт қажет. Оны EvilMail басқару панелінен алуға болады. Барлық сұрауларда кілтті Authorization тақырыбында жіберіңіз:
curl https://api.evilmail.com/v1/account
-H "Authorization: Bearer YOUR_API_KEY"Негізгі API сұраулары
Пошта жәшігін жасау
curl -X POST https://api.evilmail.com/v1/mailboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"address": "[email protected]", "password": "қауіпсіз-құпиясөз"}'Хаттар тізімін алу
curl https://api.evilmail.com/v1/mailboxes/{mailbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"Хатты оқу
curl https://api.evilmail.com/v1/messages/{message_id}
-H "Authorization: Bearer YOUR_API_KEY"Хат жіберу
curl -X POST https://api.evilmail.com/v1/messages
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Сәлем",
"body": "Бұл сынақ хаты."
}'Webhook интеграциясы
EvilMail жаңа хат келгенде webhook арқылы сіздің серверіңізге хабарлама жіберуі мүмкін. Webhook URL мекенжайын басқару панелінен немесе API арқылы баптаңыз:
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"url": "https://сіздің-сервер.com/webhook/email",
"events": ["message.received", "message.sent"]
}'Қателерді басқару
API стандартты HTTP күй кодтарын қайтарады:
- 200 — сәтті сұрау
- 201 — ресурс жасалды
- 400 — қате сұрау
- 401 — аутентификация қатесі
- 429 — сұраулар шегіне жетті (rate limiting)
- 500 — ішкі сервер қатесі
Rate Limiting
API сұраулары минутына 60-қа шектелген. Ағымдағы лимитті жауап тақырыптарында көруге болады: X-RateLimit-Remaining.
АлдыңғыDNS жазбалары түсінікті тілде: A, MX, CNAME, TXT және тағы басқаларКелесіThunderbird, Outlook және Apple Mail бағдарламаларын POP3 және IMAP арқылы EvilMail-ге қосу