API Dokümantasyonu

NonMail API dokümantasyonuna hoş geldiniz! Bu API, geçici e-posta adreslerini programatik olarak oluşturmanıza ve yönetmenize olanak tanır.

API Uç Noktaları

API'miz basit ve kullanımı kolay olacak şekilde tasarlanmıştır. Tüm uç noktalar https://api.nonmail.com/v1/

POST/v1/email/create

Yeni geçici e-posta adresi oluştur

Yeni bir geçici e-posta adresi oluşturur.

İstek Gövdesi:

json

{{
  "duration": 300,
  "prefix": "my-temp-mail"
}}

Yanıt:

json

{{
  "status": "success",
  "email": "my-temp-mail_12345@nonmail.com",
  "token": "your_access_token",
  "expires_at": 1678886400
}}

GET/v1/email/inbox

Bir adres için e-postaları al

Belirli bir geçici e-posta adresine gelen tüm e-postaları alır.

Başlıklar:

bash

Authorization: Bearer your_access_token

Yanıt:

json

{{
  "status": "success",
  "emails": [
    {{
      "id": "email_id_1",
      "from": "sender@example.com",
      "subject": "NonMail'den Merhaba",
      "body_preview": "Bu e-posta içeriğinin bir önizlemesi...",
      "received_at": 1678885000
    }}
  ]
}}

GET/v1/email/message/email_id_1

Belirli bir e-posta al

Belirli bir e-postanın tam içeriğini alır.

Başlıklar:

bash

Authorization: Bearer your_access_token

Yanıt:

json

{{
  "status": "success",
  "id": "email_id_1",
  "from": "sender@example.com",
  "subject": "NonMail'den Merhaba",
  "body": "<html><body><p>Tam e-posta içeriği burada.</p></body></html>",
  "received_at": 1678885000
}}

Kimlik Doğrulama

Tüm kimlik doğrulamalı uç noktalar, yeni bir e-posta oluştururken elde edilen bir API token'ı gerektirir. Bu token'ı Authorization başlığında Bearer token olarak geçirin.

bash

Authorization: Bearer your_access_token

Hata Yönetimi

API'miz, bir API isteğinin başarısını veya başarısızlığını belirtmek için standart HTTP durum kodlarını kullanır.

200 OKİstek başarılıydı.

400 Hatalı İstekİstek hatalı veya geçersizdi.

401 YetkisizAPI token eksik veya geçersiz.

404 Bulunamadıİstenen kaynak bulunamadı.

500 İç Sunucu HatasıBizim tarafımızda bir şeyler ters gitti.

Hız Sınırlaması

Adil kullanım sağlamak için hız sınırları uyguluyoruz. Şu anda IP adresi başına dakikada 100 istek yapmanıza izin veriliyor. Bu limiti aşmak 429 Too Many Requests hatası ile sonuçlanacaktır.

Dil Desteği

API dokümantasyonu 8 dilde mevcuttur. İstediğiniz dili, API isteklerinizde Accept-Language başlığını ayarlayarak veya dokümantasyon sayfasında seçerek belirtebilirsiniz.

Örnek: Arapça için Accept-Language: ar.

bash

Accept-Language: ar

Destek

Herhangi bir sorunuz varsa veya sorunlarla karşılaşırsanız, lütfen destek ekibimizle support@nonmail.com adresinden iletişime geçin.

Kullanım Örneği

İşte API'yi curl ile nasıl kullanacağınızın tam bir örneği:

bash

curl -X POST https://api.nonmail.com/v1/email/create \
  -H "Content-Type: application/json" \
  -d '{{
    "duration": 300,
    "prefix": "my-temp-mail"
  }}'