API dokümantasyonu

Geçici mailboxları uygulamalarınıza ve testlerinize basit bir JSON API ile entegre edin.

Temel URL


                    https://10dk.zcnstore.com/api/temp-mail

Genel bakış

ZCN Temp Mail API, geçici mailboxları programatik olarak oluşturmanıza, gelen mesajları çekmenize ve kendi script / uygulamalarınızdan yönetmenize izin verir.

Yetkilendirme

Burada anlatılan public API endpointleri ayrı bir kimlik doğrulama gerektirmez, ancak rate limiting ve abuse korumasına tabidir. Lütfen API’yi aşırı zorlamayın ve mümkün olduğunda sonuçları cache edin.

Endpointler

GET /api/temp-mail/domains

Aktif temp-mail domainlerini prefix ve pattern yapılandırmasıyla birlikte döner.

GET https://10dk.zcnstore.com/api/temp-mail/domains

POST /api/temp-mail/mailbox

Yeni bir geçici mailbox oluşturur ve id, adres ve recovery token bilgilerini döner.

Body (JSON, optional fields):

{
  "domain": "example.com",     // optional, one of the active domains
  "pattern_key": "mixed_default"  // optional, local-part pattern key
}

POST /api/temp-mail/mailbox/recover

Token-only recovery: send a JSON body with a single token field to reopen an inbox by its recovery token.

curl -X POST "https://10dk.zcnstore.com/api/temp-mail/mailbox/recover" \
  -H "Content-Type: application/json" \
  -d '{"token": "RECOVERY_TOKEN"}'

GET /api/temp-mail/mailbox/{mailbox}/emails?token={recovery_token}

Belirli bir mailbox için alınan e-posta listesini döner.

GET https://10dk.zcnstore.com/api/temp-mail/mailbox/{mailbox}/emails?token={recovery_token}

GET /api/temp-mail/mailbox/{mailbox}/emails/{emailId}?token={recovery_token}

Returns the full HTML content for a single email in the inbox.

GET https://10dk.zcnstore.com/api/temp-mail/mailbox/{mailbox}/emails/{emailId}?token={recovery_token}

GET /api/temp-mail/mailbox/{mailbox}/history?filter=favorites&token={recovery_token}

Belirli bir mailbox için favori olarak işaretlenen e-postaları history endpointi (filter=favorites) üzerinden döner.

GET https://10dk.zcnstore.com/api/temp-mail/mailbox/{mailbox}/history?filter=favorites&token={recovery_token}

Other endpoints

GET /api/temp-mail/mailbox/{mailbox}/emails/{emailId}/attachments/{attachmentIndex}?token={recovery_token} – download a single attachment from an email.

POST /api/temp-mail/mailbox/{mailbox}/emails/{emailId}/favorite?token={recovery_token} – mark or unmark an email as favorite.

DELETE /api/temp-mail/mailbox/{mailbox}?token={recovery_token} – delete a mailbox and its messages.

Örnekler

cURL ile mailbox oluşturma

curl -X POST "https://10dk.zcnstore.com/api/temp-mail/mailbox" \
  -H "Content-Type: application/json" \
  -d '{}'

JavaScript ile domainleri çekme

fetch("https://10dk.zcnstore.com/api/temp-mail/domains")
  .then(response => response.json())
  .then(data => {
    console.log("Domains:", data.domains);
  });

Rate limitler

Mailbox oluşturma istekleri IP başına sınırlandırılmıştır. HTTP 429 cevapları alırsanız, isteklerinizi yavaşlatın veya backoff mekanizması uygulayın. Yüksek hacimli kullanım için kendi instancenizi kurmanız tavsiye edilir.

Note: inbox and history endpoints such as GET /api/temp-mail/mailbox/{mailbox_id}/emails?token={recovery_token} and GET /api/temp-mail/mailbox/{mailbox_id}/history?filter=favorites&token={recovery_token} may return HTTP 429 with a JSON body {"message": "..."} when the daily message limit for the active plan is exceeded, and only return messages that are still within the server-side retention window.