İçeriğe geç
Geliştirici

Şirketler · Deneme ortamında

Şirketi takibe al

POST/api/v1/sirket-ekle/

Şirketi sicil müdürlüğü ve sicil numarasıyla takibe alır. İstek beklemez: kayıt hemen açılır, ilanlar ve profil arka planda hazırlanır; durum_adresi ile izleyin. Aynı şirket (aynı müdürlük + aynı sicil kökü, 325075-0 = 325075) listenizde varsa ikinci kayıt açılmaz, zaten_var döner ve paket hakkınız harcanmaz. Deneme anahtarında kayıt açılmaz; yeni sicil DENEME-YAVAS akışına yönlenir.

Kimlik doğrulama

  • X-API-Keyheaderzorunlu
    ulk_…
  • X-API-Secretheaderzorunlu
    ulsk_…

Kimlik doğrulama →

İstek gövdesi application/json

  • mudurlukstringzorunlu
    Sicil müdürlüğü (ör. İSTANBUL).
  • sicil_nostringzorunlu
    Sicil numarası; rakamla başlar.
  • unvanstringisteğe bağlı
    İsteğe bağlı unvan.

Yanıt alanları

201 Takibe alındı (eklendi). application/json

  • durumstringzorunlu
    eklendi (201) ya da zaten_var (200, paket hakkı harcanmaz). Değerler: eklendi, zaten_var
  • sirket_idinteger | stringzorunlu
    Şirket kimliği: gerçek anahtarda sayısal (ör. 1234); deneme anahtarında DENEME-… metni.
  • kayit_idintegerzorunlunull olabilir
  • unvanstringisteğe bağlınull olabilir
  • mudurlukstringzorunlu
  • sicil_nostringzorunlu
  • aciklamastringisteğe bağlı
  • profilstring (uri)zorunlu
  • durum_adresistring (uri)zorunlu
    Hazırlık durumunu izleme adresi.

200 Zaten listenizde (zaten_var). application/json

Alanlar aynı: 201.

Hata yanıtları

  • 400eksik_alan ya da gecersiz_sicil.
  • 402Paket şirket hakkınız doldu (kota_doldu).
  • 405POST bekleniyor (yontem).
  • 401Anahtar yok ya da geçersiz (yetkisiz).
  • 429Saatlik istek sınırı aşıldı (hiz_siniri); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.
  • 500Beklenmeyen hata (ic_hata, taraf ulawk); kısa süre sonra yeniden deneyin.

Hata yanıtları → hata, detay, hata_ayrinti

Markdown · OpenAPI · llms.txt · © 2026 Ulawk