Başlık Yönetimi

SMS başlıklarınızı API üzerinden yönetebilirsiniz: onaylı başlıklarınızı listeleyebilir, yeni bir başlık talebi oluşturabilir ve mevcut taleplerinizin durumunu sorgulayabilirsiniz.

Onaylı Başlıkları Listeleme

SMS gönderiminde kullanabileceğiniz onaylı alfanümerik başlıklarınızı listeler.

Endpoint

GET https://sms.verimor.com.tr/v2/headers

Örnek İstek

curl "https://sms.verimor.com.tr/v2/[email protected]&password=api_sifreniz"

Yanıt

[
  { "header": "VERIMOR" },
  { "header": "BILGI" },
  { "header": "KAMPANYA" }
]

Daha önce yalnızca Verimor OİM üzerinden yapılabilen başlık başvurusu artık API üzerinden de yapılabilir. Talep oluşturulduğunda başlık Onay Bekliyor durumunda açılır; onay/ret işlemi Verimor tarafından gerçekleştirilir ve başlık BTK onayından sonra aktif olur.

Endpoint

POST https://sms.verimor.com.tr/v2/header_requests

Belge yüklemek için istek multipart/form-data formatında gönderilmelidir.

Belge yüklerken dikkat

Belge JSON gövdesiyle gönderilemez. İstek multipart/form-data olmalı ve proof alanı gerçek bir dosya olarak gönderilmelidir (örn. curl’de -F "proof=@dosya").

Content-Type: application/json ile gönderip proof alanına bir dosya yolu/metni yazarsanız belge yüklenmez ve istek INVALID_PROOF_FILE hatasıyla reddedilir — çünkü sunucu sizin makinenizdeki yerel dosya yolunu okuyamaz, dosyanın içeriğini almalıdır.

Yanlış (dosya yüklenmez):

curl -X POST 'https://sms.verimor.com.tr/v2/header_requests' \
  -H 'Content-Type: application/json' \
  -d '{"username":"...","password":"...","name":"BASLIGIM","relation":"ticari-unvan","proof":"/home/kullanici/belge.png"}'

Doğru (multipart, dosya yüklenir): aşağıdaki Örnek İstek bölümüne bakın.

Parametreler

Parametre	Zorunlu	Açıklama
`username`	Evet	API kullanıcı adınız
`password`	Evet	API şifreniz
`name`	Evet	Başlık metni. 1–11 karakter; yalnızca `A-Z a-z 0-9`, boşluk ve `* - .` karakterleri. Yasaklı kelime içeremez.
`relation`	Evet	Başlık sahiplik ilişkisi (aşağıdaki tabloya bakın)
`sub_relation`	Koşullu	`relation=temsilcilik-unvani` seçildiğinde zorunludur
`note`	Hayır	Talebe ilişkin açıklama
`proof`	Hayır	Kanıt/yetki belgesi dosyası. İzinli uzantılar: `zip rar xls xlsx pdf doc docx jpg jpeg png gif tif tiff`. En fazla 7 MB.
`iys_code`	Hayır	İYS kodu
`iys_brand_code`	Hayır	İYS marka kodu
`ahs_tin`	Hayır	AHS / VKN bilgisi

`relation` Değerleri ve İstenen Belge

Seçtiğiniz sahiplik ilişkisine göre proof alanında yüklemeniz gereken belge değişir:

Değer	Anlamı	İstenen Belge (`proof`)
`abone-no`	Abone numarası	Belge gerekmez. Verimor’daki telefon numaralarınızdan birini başlık olarak kullanmanızı sağlar.
`ad-soyad`	Ad soyad	Belge gerekmez. (Verimor ayrıca Yerleşim Yeri Belgesi talep edebilir — aşağıdaki nota bakın.)
`ticari-unvan`	Ticari unvan	İmzalı ve kaşeli Ticaret Sicil Gazetesi örneği veya Ticaret Sicil Kaydı.
`mesleki-unvan`	Mesleki unvan	Diploma veya ilgili meslek odası kayıt belgesi. (Verimor ayrıca Yerleşim Yeri Belgesi talep edebilir.)
`kamu-kurum-unvani`	Kamu kurum unvanı	İlgili Kamu Kurum ve Kuruluşundan alınmış resmi belge.
`sivil-toplum-unvani`	Sivil toplum kuruluşu unvanı	İlgili Sivil Toplum Kuruluşundan alınmış belge.
`marka-adi`	Marka adı	TPE’den (Türk Patent) marka tescil belgesi. Markanın tescil süreci tamamlanmış ve Verimor abonesine ait olmalıdır.
`temsilcilik-unvani`	Bayilik / Temsilcilik unvanı	İlgili firma veya kuruluştan izin alındığını ispatlayan belge. Ayrıca `sub_relation` zorunludur.

Örnek İstek

curl -X POST "https://sms.verimor.com.tr/v2/header_requests" \
  -F "[email protected]" \
  -F "password=api_sifreniz" \
  -F "name=FIRMAADI" \
  -F "relation=ticari-unvan" \
  -F "note=Pazarlama gönderimleri için" \
  -F "proof=@/yol/ticaret-sicil.pdf"

Yanıt formatı

/v2/header_requests uç noktalarının tüm yanıtları standart bir JSON zarfı içinde döner:

{
  "status": true,            // boolean: başarı=true, hata=false
  "error": null,             // hata kodu (string) veya null
  "errorMessage": null,      // okunabilir Türkçe hata mesajı veya null
  "data": { }                // başarıda kaynak (obje/dizi), hatada null
}

HTTP durum kodları korunur: POST başarı 201, GET başarı 200, doğrulama hatası 400, bulunamadı 404.

Yanıt (Başarılı)

201 Created — oluşturulan talep data alanında döner:

{
  "status": true,
  "error": null,
  "errorMessage": null,
  "data": {
    "id": 1234,
    "name": "FIRMAADI",
    "status": 0,
    "status_text": "Onay Bekliyor",
    "relation": "ticari-unvan",
    "sub_relation": null,
    "review_note": null,
    "created_at": "2026-06-08T10:15:00+03:00"
  }
}

Yanıt (Başarısız)

400 Bad Request — error alanında hata kodu, errorMessage alanında okunabilir Türkçe açıklama döner; data ise null olur:

{
  "status": false,
  "error": "INVALID_HEADER_NAME",
  "errorMessage": "Başlık geçersiz. 1-11 karakter olmalı; yalnızca harf, rakam, boşluk ve * - . karakterleri kullanılabilir, yasaklı kelime içeremez.",
  "data": null
}

Olası error kodları ve dönen errorMessage değerleri:

Hata Kodu (`error`)	`errorMessage`
`INVALID_HEADER_NAME`	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`	Sahiplik ilişkisi (relation) zorunludur.
`INVALID_RELATION`	Geçersiz sahiplik ilişkisi (relation).
`MISSING_SUB_RELATION`	Temsilcilik unvanı için alt ilişki (sub_relation) zorunludur.
`INVALID_PROOF_FILE`	Belge dosyası geçersiz. İzin verilen uzantılardan biri olmalı ve 7 MB’ı aşmamalı.
`DUPLICATE_HEADER` (HTTP 409)	Bu isimde bir başlık talebiniz zaten mevcut.

Mükerrer Başlık Kontrolü

Aynı hesapta aynı isimli (büyük/küçük harf duyarsız) ve reddedilmemiş/iptal edilmemiş (status 2/3 hariç) bir başlık zaten varsa, yeni talep oluşturulmaz ve HTTP 409 Conflict ile uyarı döner:

{
  "status": false,
  "error": "DUPLICATE_HEADER",
  "errorMessage": "Bu isimde bir başlık talebiniz zaten mevcut.",
  "data": null
}

Reddedilmiş (status 2) veya iptal edilmiş (status 3) bir başlıkla aynı isim için yeniden başvuru yapabilirsiniz.

Başlık Talebi Durumu Sorgulama

Oluşturduğunuz başlık taleplerinin güncel durumunu sorgulayabilirsiniz. Yalnızca kendi hesabınıza ait talepler döner.

Tüm Talepleri Listeleme

GET https://sms.verimor.com.tr/v2/header_requests

curl "https://sms.verimor.com.tr/v2/[email protected]&password=api_sifreniz"

200 OK — data alanı talep objelerinden oluşan bir dizidir:

{
  "status": true,
  "error": null,
  "errorMessage": null,
  "data": [
    {
      "id": 1234,
      "name": "FIRMAADI",
      "status": 0,
      "status_text": "Onay Bekliyor",
      "relation": "ticari-unvan",
      "sub_relation": null,
      "review_note": null,
      "created_at": "2026-06-08T10:15:00+03:00"
    }
  ]
}

Tek Bir Talebi Sorgulama

GET https://sms.verimor.com.tr/v2/header_requests/:id

curl "https://sms.verimor.com.tr/v2/header_requests/[email protected]&password=api_sifreniz"

200 OK — data alanı tek bir talep objesidir:

{
  "status": true,
  "error": null,
  "errorMessage": null,
  "data": {
    "id": 1234,
    "name": "FIRMAADI",
    "status": 0,
    "status_text": "Onay Bekliyor",
    "relation": "ticari-unvan",
    "sub_relation": null,
    "review_note": null,
    "created_at": "2026-06-08T10:15:00+03:00"
  }
}

Talep bulunamazsa (veya size ait değilse) 404 Not Found — error ve errorMessage dolu, data ise null olur:

{
  "status": false,
  "error": "HEADER_NOT_FOUND",
  "errorMessage": "Başlık talebi bulunamadı.",
  "data": null
}

Durum (`status`) Değerleri

Kod	`status_text`	Anlamı
`0`	Onay Bekliyor	Talep alındı, inceleniyor
`1`	Onaylandı	Başlık onaylandı ve kullanıma hazır
`2`	Kabul Edilmedi	Talep reddedildi (`review_note` açıklamayı içerebilir)
`4`	Yeni Sözleşme/Yerleşim Belgesi Bekleniyor	Ek belge gerekiyor
`5`	KEP Onayı Bekliyor	KEP onayı bekleniyor