İçeriğe geç

Geliştirici

Yaptırım taraması

Yaptırım taraması

POST/api/v1/yaptirim/tara/

En çok 500 adı yaptırım listelerinde tarar. Eşleşme yalnız birebir addır: adın tüm parçaları aynı olmalı (sıra, aksan ve büyük/küçük harf farkı hariç). Sonuç olası isabettir; kimlik liste kaydıyla doğrulanmalıdır. Deneme anahtarıyla kullanılamaz (401). benzer_yazim geriye uyum için kabul edilir, eşleşmeyi genişletmez.

Kimlik doğrulama

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

Kimlik doğrulama →

İstek gövdesi application/json

adlarstring | object[]zorunlu
Ad ya da {ad, tur} (en çok 500).
benzer_yazimbooleanisteğe bağlı
Geriye uyum; etkisi yok. varsayılan: true

Yanıt alanları

200 Tarama sonucu. application/json

tarananintegerzorunlu
liste_tarihistring (date)zorunlunull olabilir
listelerobject[]zorunlu
- kodstringzorunlu
- adstringzorunlu
- kayitintegerzorunlu
- guncellemestring (date-time)zorunlunull olabilir
- kaynak_tarihistring (date)zorunlunull olabilir
- indirmestring (date-time)zorunlunull olabilir
- bayatbooleanzorunlu
- urlstringzorunlu
- hatastringzorunlunull olabilir
tarama_nointegerzorunlunull olabilir
isabetlerYaptirimIsabeti[]zorunlu
- adstringzorunlu
  Listedeki ad.
- guvenstringzorunlu
  Eşleşme yalnız birebir addır (sıra, aksan ve büyük/küçük harf farkı hariç): tam. Değerler: tam, kismi, benzer
- puannumber | integerzorunlunull olabilir
- oncelikinteger | stringzorunlunull olabilir
- listestringzorunlu
  Liste kodu (BM, AB, MASAK…).
- liste_adstringzorunlunull olabilir
- liste_kaydistringzorunlunull olabilir
- programstringzorunlunull olabilir
- ayrintistringzorunlunull olabilir
- dis_idstringzorunlunull olabilir
notstringzorunlu

Hata yanıtları

400gecersiz_json.
401Anahtar yok ya da geçersiz (yetkisiz).
405POST bekleniyor.
429Saatlik istek sınırı aşıldı (hiz_siniri); Retry-After başlığı sıfırlanmaya kalan saniyeyi verir.

Hata yanıtları → hata, detay, hata_ayrinti

POSTİstek

curl -X POST "https://ulawk.com/api/v1/yaptirim/tara/" \
  -H "X-API-Key: ulk_DENEME_ANAHTARINIZ" \
  -H "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"adlar": ["Ayşe Örnek"]}'

import requests

basliklar = {"X-API-Key": "ulk_DENEME_ANAHTARINIZ", "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ"}
yanit = requests.post("https://ulawk.com/api/v1/yaptirim/tara/", headers=basliklar, json={"adlar": ["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/yaptirim/tara/", {
  method: "POST",
  headers: {
    "X-API-Key": "ulk_DENEME_ANAHTARINIZ",
    "X-API-Secret": "ulsk_DENEME_GIZLI_ANAHTARINIZ",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"adlar": ["Ayşe Örnek"]})
});
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/yaptirim/tara/");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["X-API-Key: ulk_DENEME_ANAHTARINIZ", "X-API-Secret: ulsk_DENEME_GIZLI_ANAHTARINIZ", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"adlar": ["Ayşe Örnek"]}',
]);
$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("POST"), "https://ulawk.com/api/v1/yaptirim/tara/");
istek.Content = new StringContent("{\"adlar\": [\"Ayşe Örnek\"]}", System.Text.Encoding.UTF8, "application/json");
var yanit = await http.SendAsync(istek);
var metin = await yanit.Content.ReadAsStringAsync();
Console.WriteLine($"{(int)yanit.StatusCode} {metin}");

Örnek yanıt

{
  "taranan": 1,
  "liste_tarihi": "2026-10-15",
  "listeler": [
    {
      "kod": "BM",
      "ad": "BM Güvenlik Konseyi",
      "kayit": 1000,
      "guncelleme": "2026-10-15T00:00:00+03:00",
      "kaynak_tarihi": "2026-10-14",
      "indirme": "2026-10-15T00:00:00+03:00",
      "bayat": false,
      "url": "",
      "hata": ""
    }
  ],
  "tarama_no": 42,
  "isabetler": [],
  "not": "Olası isabettir; kimlik (doğum tarihi, uyruk) liste kaydıyla doğrulanmalıdır."
}

{
  "hata": "gecersiz_json"
}

{
  "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
  }
}

{
  "hata": "yontem",
  "detay": "POST bekleniyor."
}

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
  }
}

Listeler kısaltıldı.

Markdown · OpenAPI · llms.txt · © 2026 Ulawk