Platform

vize.ws Geliştirici API ve Ülke Listesi Entegrasyonu

Vize acentesi web sitenize veya iç aracınıza ülke listesi ve vize gereksinimi verisi bağlamak istiyorsanız vize.ws Geliştirici API bu ihtiyacı JSON uçlarla karşılar. Bu yazıda hangi endpoint’lerin ne işe yaradığını ve erişimin nasıl alındığını özetliyoruz.

Ne sunuluyor?

API kapısı https://api.vize.ws üzerindedir. Başlıca iki alan:

  • Vize araçları API (/vize-araclari/v1, alias /visa/v1): ülkeler, vize kontrolü, ülke detayı, pasaport gücü
  • Kısa link API (/link/v1): kısa URL oluşturma

Site üzerindeki ülke rehberi ve sorgulama araçları da benzer veri sözleşmesini kullanır.

Sık kullanılan uçlar

EndpointKullanım
GET /countriesÜlke listesi / arama
GET /checkPasaport → hedef ülke vize kontrolü
GET /country/{iso}Tek ülke özeti
GET /passport-powerPasaport gücü listesi
GET /healthServis sağlığı

Kimlik doğrulama

İsteklerde Bearer token kullanılır. Tarayıcı çağrılarında tanımlı domain kontrolü uygulanabilir. Kapsam (scope) talebe göre açılır. Hata kodları için API hata kodları sayfasına bakılabilir.

Erişim adımları

  1. Geliştirici sayfasından talep oluşturun.
  2. Onay sonrası hesap kurulumunu tamamlayın.
  3. Panelden anahtarı alın ve izinli domainleri kontrol edin.
  4. Çağrıları api.vize.ws üzerinden yapın.

Özet

Geliştirici API; ülke listesi ve vize kontrolünü kendi arayüzünüze taşımak için kullanılır. Yolcu arayüzü vize.ws’te kalırken, entegrasyon ihtiyacı olan ekipler aynı veriyi API ile alabilir. Detaylı dokümantasyon için gelistirici sayfasına gidin.