EvilMail API a wɔde hyɛ wo application mu

API key nyaeɛ

Sɛ wopɛ sɛ wode EvilMail API di dwuma a, wohia API key kan. Kɔ wo account mu, kɔ "Settings" > "API Keys" na klik "Generate New Key". Kora wo API key wɔ baabi a ɛyɛ safe — wɔkyerɛ no prɛko pɛ. Eye sɛ wode sie sɛ environment variable, mfa nhyɛ code no mu kɛse.

Endpoints titriw

EvilMail REST API ma endpoints titriw yi:

GET    /v1/inboxes              - Kyerɛ inboxes nyinaa
POST   /v1/inboxes              - Yɛ inbox foforɔ
GET    /v1/inboxes/{id}         - Nya inbox mu nsɛm
DELETE /v1/inboxes/{id}         - Pepa inbox
GET    /v1/inboxes/{id}/messages - Kyerɛ messages
GET    /v1/messages/{id}        - Nya message mu nsɛm
POST   /v1/messages             - Mena message
GET    /v1/domains              - Kyerɛ domains

curl nhwɛsoɔ

Inbox foforɔ yɛ:

curl -X POST https://api.evilmail.com/v1/inboxes 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"name": "test-inbox", "domain": "example.com"}'

Messages nya:

curl https://api.evilmail.com/v1/inboxes/{inbox_id}/messages 
  -H "Authorization: Bearer YOUR_API_KEY"

Message mena:

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": "Test", "body": "Hello!"}'

Use cases

Wubɛtumi de EvilMail API adi dwuma wɔ nneɛma ahorow mu:

• Automated tests: Sɔ hwɛ email verification flows wɔ wo CI/CD pipeline mu.
• Throwaway emails: Yɛ temporary addresses ma users.
• Email forwarding: Fa emails a ɛba wo application mu denam webhook so.
• Monitoring: Di email traffic akyi na yɛ analysis.

Error handling

API no san de HTTP status codes a wɔtaa de di dwuma ba: 200 ayɛ yie, 201 wɔayɛ, 400 request mfomsoɔ, 401 ɛho kwan nni hɔ, 404 anhu, 429 requests dɔɔso. Sɛ rate limit no wie a, twɛn sɛnea Retry-After header no kyerɛ.