Giriş

Vignetim Partner API'ye hoş geldiniz. Bu API, vinyet satın alımlarını, eSIM veri paketlerini ve seyahat sigortası ürünlerini doğrudan platformunuza entegre etmenizi sağlar.

Temel URL (Base URL)

Tüm API istekleri şu adrese yapılır:

https://api.vignetim.com/v2/partners

API, RESTful kurallarına uyar ve JSON yanıtları döndürür. Tüm istekler HMAC-SHA256 istek imzalama ile doğrulanmalıdır.

Neler Yapabilirsiniz

Vinyet Satışı -- Avrupa ülkelerindeki mevcut otoyol vinyet biletlerini görüntüleyin ve müşterileriniz adına siparişler oluşturun.
eSIM Paketi Satışı -- Yerel, bölgesel ve küresel destinasyonları kapsayan mobil veri paketleri sunun.
Seyahat Sigortası Satışı -- Çeşitli teminat seçenekleriyle seyahat sigortası ürünleri sağlayın.
Sipariş Yönetimi -- Sipariş durumunu takip edin, sipariş geçmişini filtreleyin ve gerçek zamanlı webhook bildirimleri alın.

Sürümleme (Versioning)

Partner API, URL yolu üzerinden sürümlendirilir (/v2/). Geriye dönük uyumsuz değişiklikler yalnızca yeni ana sürümlerde yapılır. Geriye dönük uyumlu eklemeler (yeni alanlar, yeni uç noktalar) mevcut sürüme önceden bildirim yapılmadan eklenebilir.

Geliştirici Kaynakları

Kaynak	Bağlantı
OpenAPI Tanımı (JSON)	vignetim.com/api/partner-openapi
Swagger UI	api.vignetim.com/docs
Postman'a Aktarma	Yukarıdaki OpenAPI URL'sini kopyalayın ve Postman'da File > Import > Link seçeneğini kullanın
MCP Sunucusu	`claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp`

İpucu: OpenAPI tanımını Postman, Insomnia veya herhangi bir API istemcisine aktararak tüm uç noktalar ve şemalarla hazır istek şablonları elde edebilirsiniz.

Hızlı Başlangıç

API kimlik bilgilerinizi alın -- Bir partner hesabı oluşturun ve kontrol panelinizden API anahtarınızı ve gizli anahtarınızı edinin.
Sandbox ortamını kullanın -- Simüle edilmiş ödemeler ve gerçek ücretlendirme olmadan entegrasyonunuzu test etmek için sandbox modunda başlayın.
İstekleri doğrulayın -- Her isteği gerekli başlıklarla HMAC-SHA256 kullanarak imzalayın.
Ürünlere göz atın -- Mevcut vinyet, eSIM paketleri veya sigorta ürünlerini listeleyin.
Sipariş oluşturun -- Ürün seçimi, ödeme bilgileri ve müşteri bilgileriyle bir sipariş gönderin.
Webhook'ları ayarlayın -- Sipariş durumu değişiklikleri hakkında gerçek zamanlı bildirimler almak için webhook uç noktaları kaydedin.

Neler Yapabilirsiniz

Vinyet Satışı -- Avrupa ülkelerindeki mevcut otoyol vinyet biletlerini görüntüleyin ve müşterileriniz adına siparişler oluşturun.

eSIM Paketi Satışı -- Yerel, bölgesel ve küresel destinasyonları kapsayan mobil veri paketleri sunun.

Seyahat Sigortası Satışı -- Çeşitli teminat seçenekleriyle seyahat sigortası ürünleri sağlayın.

Sipariş Yönetimi -- Sipariş durumunu takip edin, sipariş geçmişini filtreleyin ve gerçek zamanlı webhook bildirimleri alın.

Geliştirici Kaynakları

Kaynak	Bağlantı
OpenAPI Tanımı (JSON)	vignetim.com/api/partner-openapi
Swagger UI	api.vignetim.com/docs
Postman'a Aktarma	Yukarıdaki OpenAPI URL'sini kopyalayın ve Postman'da File > Import > Link seçeneğini kullanın
MCP Sunucusu	`claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp`

İpucu: OpenAPI tanımını Postman, Insomnia veya herhangi bir API istemcisine aktararak tüm uç noktalar ve şemalarla hazır istek şablonları elde edebilirsiniz.

Hızlı Başlangıç

API kimlik bilgilerinizi alın -- Bir partner hesabı oluşturun ve kontrol panelinizden API anahtarınızı ve gizli anahtarınızı edinin.

Sandbox ortamını kullanın -- Simüle edilmiş ödemeler ve gerçek ücretlendirme olmadan entegrasyonunuzu test etmek için sandbox modunda başlayın.

İstekleri doğrulayın -- Her isteği gerekli başlıklarla HMAC-SHA256 kullanarak imzalayın.

Ürünlere göz atın -- Mevcut vinyet, eSIM paketleri veya sigorta ürünlerini listeleyin.

Sipariş oluşturun -- Ürün seçimi, ödeme bilgileri ve müşteri bilgileriyle bir sipariş gönderin.

Webhook'ları ayarlayın -- Sipariş durumu değişiklikleri hakkında gerçek zamanlı bildirimler almak için webhook uç noktaları kaydedin.