Doğrulama ve imza · Deneme ortamında

İmza kontrolü (sorguyla) ve kişi listesi

GET/api/v1/sirketler/{sirket_id}/imza-kontrol/

kisi verilmezse profildeki yetkili adları (görevdekiler önce) döner; verilirse POST ile aynı kontrol sorgu parametreleriyle yapılır (birlikte tekrarlanabilir ya da virgüllü).

Kimlik doğrulama

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

Kimlik doğrulama →

Yol parametreleri

sirket_idinteger | stringzorunlu
Şirket kimliği (/api/v1/sirketler/ listesindeki id).

Sorgu parametreleri

kisistringisteğe bağlı
Yetkilinin adı soyadı.
tarihstring (date)isteğe bağlı
YYYY-AA-GG (varsayılan bugün).
tutarstringisteğe bağlı
İşlem tutarı.
para_birimistringisteğe bağlı
Para birimi. varsayılan: TRY
islemstringisteğe bağlı
İşlem türü.
birliktestringisteğe bağlı
Birlikte imzalayacaklar (virgüllü).

Yanıt alanları

200 kisi yoksa kişi listesi, varsa kontrol sonucu. application/json

Hata yanıtları

400gecersiz_tarih, gecersiz_tutar, gecersiz_parametre.
404Bulunamadı ya da erişim yetkiniz yok (bulunamadi).
503Resmî kaynak şu an erişilemiyor (kaynak_erisilemiyor, taraf kaynak). Deneme ortamında DENEME-KAYNAK-KAPALI.
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

import requests basliklar = {"X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ"} yanit = requests.get("https://ulawk.com/api/v1/sirketler/DENEME-100001/imza-kontrol/", headers=basliklar, params={"kisi": "Ayşe Örnek"}, timeout=30) veri = yanit.json() if not yanit.ok: # hata_ayrinti.tekrar_denenebilir ise Retry-After kadar bekleyip yeniden deneyin print(yanit.status_code, veri["hata_ayrinti"]) print(veri)

const yanit = await fetch("https://ulawk.com/api/v1/sirketler/DENEME-100001/imza-kontrol/?kisi=Ay%C5%9Fe+%C3%96rnek", { method: "GET", headers: { "X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ" } }); const veri = await yanit.json(); if (!yanit.ok) console.error(yanit.status, veri.hata_ayrinti); console.log(veri);

<?php $ch = curl_init("https://ulawk.com/api/v1/sirketler/DENEME-100001/imza-kontrol/?kisi=Ay%C5%9Fe+%C3%96rnek"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: ulk_DENEME_ANAHTARINIZ", "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ"], ]); $govde = curl_exec($ch); $kod = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $veri = json_decode($govde, true); var_dump($kod, $veri);

using var http = new HttpClient(); http.DefaultRequestHeaders.Add("X-API-Key", "ulk_DENEME_ANAHTARINIZ"); http.DefaultRequestHeaders.Add("X-API-Secret", "ulsk_DENEME_GIZLI_ANAHTARINIZ"); var istek = new HttpRequestMessage(new HttpMethod("GET"), "https://ulawk.com/api/v1/sirketler/DENEME-100001/imza-kontrol/?kisi=Ay%C5%9Fe+%C3%96rnek"); var yanit = await http.SendAsync(istek); var metin = await yanit.Content.ReadAsStringAsync(); Console.WriteLine($"{(int)yanit.StatusCode} {metin}");

{ "sirket": { "id": "DENEME-100001", "unvan": "ÖRNEK DENEME SANAYİ VE TİCARET ANONİM ŞİRKETİ", "mudurluk": "İSTANBUL", "sicil_no": "DENEME-100001" }, "profil_hazir": true, "kisiler": [ { "isim": "Ali Denemeci", "gorevde": true }, { "isim": "Ayşe Örnek", "gorevde": true } ] }

{ "hata": "gecersiz_tarih", "detay": "tarih YYYY-AA-GG olmalı", "hata_ayrinti": { "kod": "gecersiz_tarih", "mesaj": "tarih YYYY-AA-GG olmalı", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

{ "hata": "bulunamadi", "detay": "Şirket bulunamadı ya da erişim yetkiniz yok.", "hata_ayrinti": { "kod": "bulunamadi", "mesaj": "Şirket bulunamadı ya da erişim yetkiniz yok.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

Retry-After: 300 { "hata": "kaynak_erisilemiyor", "detay": "Ticaret Sicili Gazetesi şu an yanıt vermiyor; kısa süre sonra yeniden deneyin. (Deneme ortamı benzetimi.)", "hata_ayrinti": { "kod": "kaynak_erisilemiyor", "mesaj": "Ticaret Sicili Gazetesi şu an yanıt vermiyor; kısa süre sonra yeniden deneyin. (Deneme ortamı benzetimi.)", "taraf": "kaynak", "kaynak": "ttsg", "tekrar_denenebilir": true, "tekrar_sn": 300 } }

{ "hata": "yetkisiz", "detay": "Geçerli X-API-Key başlığı gerekli (panel › API).", "hata_ayrinti": { "kod": "yetkisiz", "mesaj": "Geçerli X-API-Key başlığı gerekli (panel › API).", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": false, "tekrar_sn": null } }

Retry-After: 66 { "hata": "hiz_siniri", "detay": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "hata_ayrinti": { "kod": "hiz_siniri", "mesaj": "Saatlik istek sınırı aşıldı (600). Bir sonraki saatte tekrar deneyin.", "taraf": "istemci", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 66 } }

Retry-After: 60 { "hata": "ic_hata", "detay": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "hata_ayrinti": { "kod": "ic_hata", "mesaj": "Beklenmeyen bir hata oluştu; kısa süre sonra yeniden deneyin.", "taraf": "ulawk", "kaynak": null, "tekrar_denenebilir": true, "tekrar_sn": 60 } }

İmza kontrolü (sorguyla) ve kişi listesi

#Kimlik doğrulama

#Yol parametreleri

#Sorgu parametreleri

#Yanıt alanları

#Hata yanıtları

Kimlik doğrulama

Yol parametreleri

Sorgu parametreleri

Yanıt alanları

Hata yanıtları