Test Mesajı 1

## Kimlik Doğrulama

API anahtarını nasıl alacağınızı ve kullanacağınızı öğrenin

## API Anahtarı Alın

API'yi kullanmadan önce bir API anahtarı almanız gerekir. Profil sayfanızdan API anahtarınızı oluşturabilirsiniz.

### API Anahtarını Kullanma

Tüm API isteklerinde istek başlığına API anahtarınızı ekleyin:

[Code (bash)]
X-API-Key: YOUR_API_KEY
[/Code]

### Önemli Notlar

- API anahtarınızı güvenli tutun ve halka açık yerlerde kullanmayın
- API anahtarı hesabınızla aynı izinlere sahiptir, dikkatli kullanın
- API anahtarınız ele geçirildiyse, hemen profil sayfanızdan yeni bir tane oluşturun

---

## E-Posta API

E-postalar oluşturun ve yönetin

## Mevcut Domain'leri Alın

Sistemdeki tüm mevcut e-posta domain'lerini alın.

### İstek

[Code (bash)]
GET /api/email/domains
[/Code]

### İstek Örneği

[Code (bash)]
curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
domains | array | Mevcut e-posta domain'lerinin listesi

### Yanıt Örneği

[Code (json)]
{
  "domains": [
    "chat-tempmail.com",
    "example.com", 
    "other-domain.com"
  ]
}
[/Code]

## E-Posta Oluştur

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

### İstek

[Code (bash)]
POST /api/emails/generate
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
name | string | Evet | E-posta öneki
expiryTime | number | Evet | Süre sonu (milisaniye)<br/>Mevcut değerler:<br/>- 3600000 (1 saat)<br/>- 86400000 (1 gün)<br/>- 259200000 (3 gün)<br/>- 0 (kalıcı)
domain | string | Evet | E-posta domain'i

### İstek Örneği

[Code (bash)]
curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test",
    "expiryTime": 3600000,
    "domain": "chat-tempmail.com"
  }'
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
id | string | E-posta benzersiz tanımlayıcısı (UUID formatı)
email | string | Oluşturulan e-posta adresi (tam e-posta adresi)

### Yanıt Örneği

[Code (json)]
{
  "id": "c2c4f894-c672-4d5b-a918-abca95aff1f7",
  "email": "test@chat-tempmail.com"
}
[/Code]

## E-Posta Listesini Alın

Hesabınız altındaki tüm e-posta adreslerini alın.

### İstek

[Code (bash)]
GET /api/emails
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
cursor | string | Hayır | Sayfalama imleci, önceki yanıttan nextCursor alın

### İstek Örneği

[Code (bash)]
curl https://chat-tempmail.com/api/emails \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
emails | array | E-posta listesi (istek başına en fazla 20 öğe)
nextCursor | string | Daha fazla veri için sonraki sayfa imleci
total | number | Toplam e-posta sayısı

### emails Dizisindeki E-Posta Nesneleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
id | string | E-posta benzersiz tanımlayıcısı (UUID formatı)
address | string | E-posta adresi (tam e-posta adresi)
userId | string | E-posta sahibinin kullanıcı ID'si (UUID formatı)
createdAt | string | E-posta oluşturulma zamanı (ISO 8601 formatı)
expiresAt | string | E-posta sona erme zamanı (ISO 8601 formatı)

### Yanıt Örneği

[Code (json)]
{
  "emails": [
    {
      "id": "e4ff5c14-8a72-48c5-bd13-b5347fb944da",
      "address": "6Tg3VT@chat-tempmail.com",
      "userId": "bd08008d-e944-44b2-a0d0-67f2b528ee6d",
      "createdAt": "2025-04-21T08:30:45.084Z",
      "expiresAt": "2025-04-22T08:30:45.084Z"
    }
  ],
  "nextCursor": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
  "total": 20
}
[/Code]

## E-Posta Sil

Belirtilen e-posta adresini silin.

### İstek

[Code (bash)]
DELETE /api/emails/{emailId}
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
emailId | string | Evet | E-posta ID'si (yol parametresi)

### İstek Örneği

[Code (bash)]
curl -X DELETE "https://chat-tempmail.com/api/emails/99fadf12-6826-490a-9c6c-b0b528d4a8e0" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
success | boolean | Silme işleminin başarılı olup olmadığı

### Yanıt Örneği

[Code (json)]
{
  "success": true
}
[/Code]

---

## Mesajlar API

Mesajları yönetin

## Mesaj Listesini Alın

Belirtilen e-posta adresindeki tüm mesajları alın.

### İstek

[Code (bash)]
GET /api/emails/{emailId}
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
emailId | string | Evet | E-posta ID'si (yol parametresi)
cursor | string | Hayır | Sayfalama imleci (sorgu parametresi), önceki yanıttan nextCursor alın

### İstek Örneği

[Code (bash)]
curl "https://chat-tempmail.com/api/emails/c2c4f894-c672-4d5b-a918-abca95aff1f7" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
messages | array | Mesaj listesi (istek başına en fazla 20 öğe)
nextCursor | string | Daha fazla veri için sonraki sayfa imleci
total | number | Toplam mesaj sayısı

### messages Dizisindeki Mesaj Nesneleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
id | string | Mesaj benzersiz tanımlayıcısı (UUID formatı)
from_address | string | Gönderen adresi
subject | string | Mesaj konusu
received_at | number | Alınma zamanı (Unix zaman damgası, milisaniye)

### Yanıt Örneği

[Code (json)]
{
  "messages": [
    {
      "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
      "from_address": "sender1@example.com",
      "subject": "Test Mesajı 1 - xJOK2h",
      "received_at": 1745224245084
    }
  ],
  "nextCursor": "eyJ0aW1lc3RhbXAiOjE3NDUxNTU4NDUwODQsImlkIjoiNjNmNzFlODYtOGE1NC00ZDQ0LTk5ZWYtN2QzNTBhMTQ4M2JiIn0=",
  "total": 50
}
[/Code]

## Mesaj Detaylarını Alın

Belirtilen mesajın detaylı içeriğini alın.

### İstek

[Code (bash)]
GET /api/emails/{emailId}/{messageId}
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
emailId | string | Evet | E-posta ID'si (yol parametresi)
messageId | string | Evet | Mesaj ID'si (yol parametresi)

### İstek Örneği

[Code (bash)]
curl "https://chat-tempmail.com/api/emails/99fadf12-6826-490a-9c6c-b0b528d4a8e0/fd13a8df-1465-4fbc-a612-ca7311c31ff2" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
message | object | Mesaj detayları

### message Nesnesi Alanları

Parametre | Tip | Açıklama
----------- | ----- | ----------
id | string | Mesaj benzersiz tanımlayıcısı (UUID formatı)
from_address | string | Gönderen adresi
subject | string | Mesaj konusu
content | string | Düz metin olarak mesaj içeriği
html | string | HTML olarak mesaj içeriği (boş olabilir)
received_at | number | Alınma zamanı (Unix zaman damgası, milisaniye)

### Yanıt Örneği

[Code (json)]
{
  "message": {
    "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
    "from_address": "sender1@example.com",
    "subject": "Test Mesajı 1 - xJOK2h",
    "content": "Test Mesajı 1\n\nBu Test Mesajı 1'in içeriğidir.\n\nSaygılarımla,\nGönderen 1",
    "html": "<div>\n<h1>Test Mesajı 1</h1>\n </div>",
    "received_at": 1745224245084
  }
}
[/Code]

## Mesaj Sil

Belirtilen mesajı silin.

### İstek

[Code (bash)]
DELETE /api/emails/{emailId}/{messageId}
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
emailId | string | Evet | E-posta ID'si (yol parametresi)
messageId | string | Evet | Mesaj ID'si (yol parametresi)

### İstek Örneği

[Code (bash)]
curl -X DELETE "https://chat-tempmail.com/api/emails/76d91ae5-822a-4fdd-8701-9de038ec86d7/20e77445-b0c3-4e8b-aa29-762ea423ac15" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
success | boolean | Silme işleminin başarılı olup olmadığı

### Yanıt Örneği

[Code (json)]
{
  "success": true
}
[/Code]

---

## Webhook Push

Mesajlar için push bildirimleri almak üzere webhook yapılandırın

## Webhook Yapılandırmasını Alın

Mevcut webhook yapılandırma bilgilerini alın.

### İstek

[Code (bash)]
GET /api/webhook
[/Code]

### İstek Örneği

[Code (bash)]
curl https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
url | string | Webhook URL adresi (boş dize olabilir)
enabled | boolean | Webhook'un etkin olup olmadığı

### Yanıt Örneği

[Code (json)]
{
  "url": "https://your-server.com/webhook",
  "enabled": true
}
[/Code]

## Webhook Yapılandır

Webhook yapılandırmasını ayarlayın veya güncelleyin.

### İstek

[Code (bash)]
POST /api/webhook
[/Code]

### İstek Parametreleri

Parametre | Tip | Zorunlu | Açıklama
----------- | ----- | --------- | ----------
url | string | Evet | Webhook URL adresi (geçerli HTTP/HTTPS URL olmalıdır)
enabled | boolean | Evet | Webhook'un etkinleştirilip etkinleştirilmeyeceği

### İstek Örneği

[Code (bash)]
curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "enabled": true
  }'
[/Code]

### Yanıt Parametreleri

Parametre | Tip | Açıklama
----------- | ----- | ----------
success | boolean | Yapılandırmanın başarılı olup olmadığı

### Yanıt Örneği

[Code (json)]
{
  "success": true
}
[/Code]

## Webhook Olayları

Yeni bir mesaj geldiğinde, sistem yapılandırılmış URL'nize bir POST isteği gönderir.

### Alınan Veri Formatı

İstek Başlıkları:
- Content-Type: application/json
- X-Webhook-Event: new_message

### Webhook Push Verileri

Parametre | Tip | Açıklama
----------- | ----- | ----------
emailId | string | Mesajı alan e-posta ID'si (UUID formatı)
messageId | string | Yeni mesaj ID'si (UUID formatı)
fromAddress | string | Gönderen adresi
subject | string | Mesaj konusu
content | string | Düz metin olarak mesaj içeriği
html | string | HTML olarak mesaj içeriği (boş olabilir)
receivedAt | string | Mesaj alınma zamanı (ISO 8601 formatı)
toAddress | string | Mesajı alan e-posta adresi

### Push Veri Örneği

[Code (json)]
{
  "emailId": "c2c4f894-c672-4d5b-a918-abca95aff1f7",
  "messageId": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
  "fromAddress": "sender@example.com",
  "subject": "Test Mesajı",
  "content": "Düz metin olarak mesaj içeriği",
  "html": "<div>HTML olarak mesaj içeriği</div>",
  "receivedAt": "2025-01-21T08:30:45.084Z",
  "toAddress": "test@chat-tempmail.com"
}
[/Code]

### Yanıt Gereksinimleri

Sunucunuz, başarılı alımı göstermek için 2xx durum kodu döndürmelidir. 2xx olmayan bir durum kodu döndürülürse, sistem yeniden göndermeyi deneyebilir.

Önerilen Yanıt:

[Code (json)]
HTTP/1.1 200 OK
Content-Type: application/json

{
  "received": true
}
[/Code]

### Önemli Notlar

- Webhook URL'nizin erişilebilir olduğundan emin olun
- Push verilerinin bütünlüğünü sunucu tarafınızda doğrulamanız önerilir
- Sistem, mesajlar geldiğinde webhook push'larını anında gönderir
- Push'lar başarısız olursa sistem yeniden deneyebilir, bu nedenle arayüzünüzün idempotent olduğundan emin olun

---