İçeriğe geç
Geliştirici

Şirketler · Deneme ortamında

Takip edilen şirketler

GET/api/v1/sirketler/

Takip ettiğiniz şirketler: kimlik, unvan, müdürlük, sicil no, ilan sayısı ve profil bağlantısı. Unvana göre sıralı ve sayfalıdır.

Kimlik doğrulama

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

Kimlik doğrulama →

Sorgu parametreleri

  • sayfaintegeristeğe bağlı
    Sayfa numarası (1'den). varsayılan: 1
  • adetintegeristeğe bağlı
    Sayfa başına kayıt (varsayılan 200, en çok 1000). varsayılan: 200

Yanıt alanları

200 Şirket listesi. application/json

  • adetintegerzorunlu
    Toplam kayıt.
  • sayfaintegerzorunlu
  • sayfa_adediintegerzorunlu
    Sayfa başına kayıt.
  • sonraki_sayfaintegerzorunlunull olabilir
    Sonraki sayfa; son sayfada null.
  • sirketlerSirketSatiri[]zorunlu
    • idinteger | stringzorunlu
      Şirket kimliği: gerçek anahtarda sayısal (ör. 1234); deneme anahtarında DENEME-… metni.
    • unvanstringzorunlunull olabilir
    • mudurlukstringzorunlunull olabilir
    • sicil_nostringzorunlunull olabilir
    • ilan_sayisiintegerzorunlu
    • profilstring (uri)zorunlu

Hata yanıtları

  • 400Geçersiz parametre (gecersiz_parametre, gecersiz_kategori, gecersiz_tarih…) ya da bu uç deneme anahtarıyla kullanılamaz (deneme_desteklenmiyor).
  • 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