1. Ortak esaslar
1.1 Adresler
Bölüm başlığı “1.1 Adresler”| Ortam | API | Anket formu |
|---|---|---|
| Dev | https://api.dev.cx.turkishtechlab.com | https://s.dev.cx.turkishtechlab.com |
| Prod | https://api.cx.turkishtechlab.com | https://s.air.tk |
API çağrıları mutlaka api. ön ekli adrese yapılır; panel adresi API isteklerini karşılamaz. Yük dengeleyici yönlendirmeyi host başlığına göre yapar.
1.2 Kimlik doğrulama yöntemleri
Bölüm başlığı “1.2 Kimlik doğrulama yöntemleri”| Yöntem | Nerede | Nasıl taşınır |
|---|---|---|
| Kampanya anahtarı | Link kampanyası uç noktaları | Authorization: Bearer <key> |
| Uygulama kimliği | Mobil SDK açılışı | gövdede appId + accessKey |
| Origin allowlist | Web widget | tarayıcının Origin başlığı |
| HMAC imza | Widget kimliği, push linki | gövdede/URL'de imza alanı |
| Oturum jetonu | Açılış sonrası tüm çağrılar | ?t=<token> · 45 dk ömür |
1.3 Hata biçimi
Bölüm başlığı “1.3 Hata biçimi”Tüm hatalar aynı gövdeyle döner; code makine tarafından okunmak içindir, message insan içindir.
{ "code": "unknown_built_in_response_key", "message": "...", "key": "ucus_no" }1.4 Entegrasyon Anahtarı kavramı
Bölüm başlığı “1.4 Entegrasyon Anahtarı kavramı”Dış sistemden gelen değerler anket sorularına Entegrasyon Anahtarı (externalKey) üzerinden yazılır, soru UUID’si ile değil. Anahtarı anketi hazırlayan iş birimi, soru kartındaki Entegrasyon Anahtarı alanından verir: yalnızca harf/rakam/alt çizgi, harfle başlar, en fazla 64 karakter. Eşleşme büyük/küçük harf ve ayraç duyarsızdır: dış sistemin UCUS_NO yazması ile ankette ucus_no tanımlı olması aynı soruya denk düşer, iki taraf yazımı ayrıca sözleşmek zorunda değildir.