---
title: "Hata Kodları"
---

## HTTP Durum Kodları

| Kod | Açıklama |
|-----|----------|
| `200` | Başarılı |
| `400` | Geçersiz istek parametresi |
| `401` | Kimlik doğrulama hatası |
| `403` | Yetkisiz erişim |
| `413` | Paket boyutu 10 MB limitini aştı |
| `422` | İşlenemeyen varlık |
| `429` | Rate limit aşıldı — limit endpoint'e göre değişir, bkz. [Rate Limiting](/sms/rate-limiting) |
| `500` | Sunucu hatası |

---

## Gönderim Sırasında Dönen Hata Kodları

| API Kodu | Açıklama |
|----------|----------|
| `INVALID_SOURCE_ADDRESS` | Başlık kabul edilmedi |
| `MISSING_MESSAGE` | Mesaj içeriği verilmemiş |
| `MESSAGE_TOO_LONG` | Mesaj çok uzun |
| `INVALID_PERIOD` | Geçerlilik süresi geçersiz (1 dk – 48 saat arasında olmalı) |
| `INVALID_DELIVERY_TIME` | `send_at` geçersiz veya geçmiş tarih |
| `INVALID_DATACODING` | `datacoding` parametresi hatalı |
| `MISSING_DESTINATION_ADDRESS` | Alıcı numarası verilmemiş |
| `INVALID_DESTINATION_ADDRESS` | Numara formatı geçersiz (905121234567 formatında olmalı) |
| `INVALID_UTF8` | Encoding UTF-8 olmalı |
| `MUKERRER_RAPORLAMA` | 24 saat içinde aynı SMS zaten gönderilmiş |
| `INSUFFICIENT_CREDITS` | Yetersiz bakiye |
| `FORBIDDEN_MESSAGE` | Mesaj yasak kelime içeriyor |
| `INVALID_JSON` | Geçersiz JSON |
| `MESSAGE_COUNT_LIMIT_EXCEEDED` | Tek istekte 50.000 adetten fazla mesaj kabul edilmez |
| `NUMERIC_SOURCE_ADDRESS_NOT_ALLOWED` | Alfanümerik olmayan başlıklar API üzerinden kullanılamaz |
| `MISSING_IYS_BRAND_CODE` | Ticari gönderimde başlığın marka kodu tanımlı olmalı |
| `AHS_AUTHORIZATION_ERROR` | İYS yetkilendirme hatası |
| `NO_AHS_BRAND_ERROR` | VKN'ye ait İYS'de kayıtlı marka bulunamadı |
| `INVALID_IYS_RECIPIENT_TYPE` | `iys_recipient_type` `BIREYSEL` veya `TACIR` olmalı |
| `INVALID_CONSENT_DATE` | `consent_date` geçersiz |
| `MISSING_CONSENT` | Eksik izin durumu |
| `MISSING_CONSENT_DATE` | Bireysel gönderimde `consent_date` zorunlu |
| `INVALID_RECIPIENT` | Geçersiz gönderim tipi |

---

## Başlık Talebi Hata Kodları

`POST /v2/header_requests` ve `GET /v2/header_requests/:id` uç noktalarında dönebilecek hatalar:

:::info
Bu uç noktalarda hatalar düz metin değil, standart JSON zarfı içinde döner: hata kodu `error` alanında, okunabilir Türkçe açıklama `errorMessage` alanında, `data` ise `null` olur. HTTP durum kodu doğrulama hataları için `400`, bulunamayan talep için `404` olur. Ayrıntı için [Başlık Yönetimi](/sms/baslik) sayfasına bakın.
:::

| API Kodu (`error`) | HTTP | `errorMessage` |
|----------|------|----------------|
| `INVALID_HEADER_NAME` | 400 | Başlık geçersiz. 1-11 karakter olmalı; yalnızca harf, rakam, boşluk ve * - . karakterleri kullanılabilir, yasaklı kelime içeremez. |
| `MISSING_RELATION` | 400 | Sahiplik ilişkisi (relation) zorunludur. |
| `INVALID_RELATION` | 400 | Geçersiz sahiplik ilişkisi (relation). |
| `MISSING_SUB_RELATION` | 400 | Temsilcilik unvanı için alt ilişki (sub_relation) zorunludur. |
| `INVALID_PROOF_FILE` | 400 | Belge dosyası geçersiz. İzin verilen uzantılardan biri olmalı ve 7 MB'ı aşmamalı. |
| `DUPLICATE_HEADER` | 409 | Bu isimde bir başlık talebiniz zaten mevcut. |
| `HEADER_NOT_FOUND` | 404 | Başlık talebi bulunamadı. |

Ayrıntılar için [Başlık Yönetimi](/sms/baslik) sayfasına bakın.

---

## Mesaj Durum Hata Kodları (GSM Error)

İletilemeyen mesajlar için operatörden alınan teknik hata kodları:

| No | Kod | Açıklama |
|----|-----|----------|
| 1 | `EC_UNKNOWN_SUBSCRIBER` | Numara operatör veritabanında kayıtlı değil |
| 6 | `EC_ABSENT_SUBSCRIBER_SM` | Telefon kapalı veya sinyal yok |
| 11 | `EC_TELESERVICE_NOT_PROVISIONED` | Mobil hizmet operatör tarafından durdurulmuş |
| 13 | `EC_CALL_BARRED` | Abone DND (Rahatsız Etme) modunda |
| 27 | `EC_ABSENT_SUBSCRIBER` | Telefon kapatılmış |
| 31 | `EC_SUBSCRIBER_BUSY_FOR_MT_SMS` | Operatör aşırı trafik nedeniyle meşgul |
| 32 | `EC_SM_DELIVERY_FAILURE` | Operatör mesajı abonesine iletemiyor |
| 34 | `EC_SYSTEM_FAILURE` | Operatör sistem hatası |
| 256 | `EC_SM_DF_MEMORYCAPACITYEXCEEDED` | Telefon belleği dolu |
| 502 | `EC_NO_RESPONSE` | Mesaj gönderildi; iletim raporu dönmedi |
| 2048 | `EC_TIME_OUT` | Geçerlilik süresi içinde iletilemedi |
| 2049 | `EC_IMSI_BLACKLISTED` | SIM kart operatörün kara listesinde |
| 2050 | `EC_DEST_ADDRESS_BLACKLISTED` | Numara kara listede |
| 4100 | `EC_MESSAGE_CANCELED` | Geçerlilik süresi içinde iletilemedi |
| 4103 | `EC_DESTINATION_FLOODING` | Alıcı çok fazla mesaj aldı |
| 4104 | `EC_DESTINATION_TXT_FLOODING` | Aynı içerik çok defa gönderilmiş |