Dokümantasyon

Kimlik doğrulama

Anahtarınızı Authorization: Bearer <key> başlığında gönderin. Anahtarlar yalnızca oluşturulurken bir kez gösterilir; sunucuda yalnız SHA-256 hash'i saklanır. Kaybederseniz rotate edin.

• svai_test_… — test modu, faturalandırılmaz, ayrı kullanım sayacı.
• svai_live_… — canlı mod, plan kotasından düşer.

Yanıt formatı

{
  "request_id": "req_8f2c…",
  "data": { "...": "..." },
  "meta": {
    "units": 1,
    "livemode": false,
    "last_verified_at": "2025-01-12",
    "sources": [
      { "organization": "Auswärtiges Amt", "url": "https://…", "official": true, "last_checked_at": "2025-01-12" }
    ],
    "disclaimer": "…"
  }
}

Bilinmeyen sayısal değerler tahmin edilmez, null döner. Yanıtlar resmî konsolosluk kararının yerine geçmez.

Rate limit

Her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını içerir. Limit aşımında HTTP 429 ve rate_limit_exceeded döner. Üstel geri çekilme ile yeniden deneyin.

Hata kodları

Örnekler

curl "https://schengenvizeai.com/api/v1/requirements?country=almanya&travel_purpose=tourism" \
  -H "Authorization: Bearer $SVAI_KEY"

const res = await fetch("https://schengenvizeai.com/api/v1/route", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SVAI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ question: "Vizem reddedildi ne yapmalıyım?" }),
});
const json = await res.json();

import os, requests

r = requests.get(
    "https://schengenvizeai.com/api/v1/countries/almanya",
    headers={"Authorization": f"Bearer {os.environ['SVAI_KEY']}"},
    timeout=15,
)
r.raise_for_status()
print(r.json()["meta"]["sources"])

Endpoint referansı

• POST /v1/route

  Soruyu Schengen niyetine ve doğru servise yönlendirir.

• POST /v1/classify

  Serbest metinden niyet, ülke, seyahat amacı ve profil çıkarır.

• GET /v1/countries

  Yayımlanmış ülke kayıtlarının listesi.

• GET /v1/countries/{country}

  Tek ülkenin doğrulanmış başvuru bilgisi.

• GET /v1/requirements

  Ülke + seyahat amacına göre belge gereklilikleri.

• GET /v1/financial-requirements

  Maddi yeterlilik gerekliliği ve hesaplama yöntemi.

• GET /v1/sources

  Kaynak kayıt defteri sorgusu.

• POST /v1/answer

  Kaynak temelli Schengen cevabı.

• GET /v1/appointments

  Randevu gözlem verisi (entegrasyon bekleniyor).

• POST /v1/refusal/analyze

  Ret analizi (entegrasyon bekleniyor).

• POST /v1/entry-ban/analyze

  Giriş yasağı analizi (entegrasyon bekleniyor).

• POST /v1/visa-status/analyze

  Vize sonuç süreci analizi (entegrasyon bekleniyor).

Makine okunur sözleşme: /openapi.json · Playground