Run2Mail'e karşı derleme

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

API anahtarları Kimlik doğrulama Çekirdek Uç Noktalar Hata kodları

API anahtarları

Kontrol panelinizden geliştirici API anahtarları oluşturun. Her anahtar yalnızca bir kez tam olarak gösterilir ve daha sonra gelecekteki doğrulama için güvenli bir karma olarak saklanır.

Oturum açtığınız kontrol panelinizden anahtarlar oluşturun.
Anahtarları gizli tutun ve bunları kendi gizli yöneticinizde saklayın.
Bir cihazın, komut dosyasının veya ekip arkadaşının artık erişime ihtiyacı olmadığında eski anahtarları iptal edin.

Kimlik doğrulama

Korunan her istek için Yetkilendirme başlığında bir Taşıyıcı belirteci kullanın.

Authorization: Bearer YOUR_API_KEY

Anahtar geçersizse, iptal edilmişse veya eksikse API, bir kimlik doğrulama hatasıyla yanıt verir.

Çekirdek Uç Noktalar

En yaygın iş akışı şudur: Kimliği doğrulanmış kullanıcıyı inceleyin, bir gelen kutusu oluşturun ve ardından bu gelen kutusundan iletileri alın.

Cari hesabı kontrol et

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Gelen kutusu oluştur

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Gelen kutusu mesajlarını getir

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Örnek JSON yanıtı

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Hız sınırlaması

Run2Mail, hizmeti korumak ve API erişimini istikrarlı tutmak için plan bazlı istek limitleri ve günlük gelen kutusu oluşturma limitleri uygular.

Dakika başına ücret limitleri aktif planınıza bağlıdır.
E-posta oluşturma sınırları, temel okuma çağrılarından ayrı olarak izlenir.
Kullanım, yönetici analiz panosunda görünürlük için günlüğe kaydedilir.

Hata kodları

401: Eksik veya geçersiz API kimlik bilgileri.
403: İstek için erişim engellendi, kısıtlandı veya izin verilmiyor.
429: İstek hacmi mevcut sınırı aştı.
503: Geliştirici API'si platform tarafından geçici olarak devre dışı bırakıldı.

Dashboard API ekran görüntüleri çok yakında

Bu alan, API anahtar yöneticisinin ve kullanım kontrol panelinin gelecekteki ekran görüntüleri için ayrılmıştır.

Gelistirici API