Zolpix, çok dilli sosyal medya hizmet kataloğunu yayınlar. Bu herkese açık entegrasyon salt okunurdur; sipariş veremez, ödeme alamaz, hesap yönetemez veya sosyal medya hizmeti teslim edemez.
Ne zaman kullanılmalı?
Yayınlanmış platform ve hizmet paketlerini keşfetmek, paket miktarlarını ve taban fiyatlarını karşılaştırmak, ilgili ürün sayfasını bulmak için kullanın. Türkçe (tr), İngilizce (en) veya Hırvatça (hr) içerik için locale parametresini gönderin. Görünen bir paketin gerçek satışa açık olduğunu varsaymayın: purchase_mode ve live_purchase_available alanlarını kontrol edin. Yayınlanan koşullar desteklemiyorsa organik büyüme, doğrulanmış takipçi, teslim süresi, iade veya platform onayı sözü vermeyin.
Nasıl çağrılır?
Kimlik doğrulama gerekmez. Accept: application/json başlığıyla GET /api/v1/catalog?locale=tr isteği gönderin. Parametre yoksa dil en olur. Yanıt yayınlanmış platformları, hizmetleri ve paketleri içerir; taslaklar ve özel müşteri bilgileri dahil edilmez. Fiyatlar TRY’nin tam sayı alt birimleriyle ifade edilir; 100 alt birim 1 TRY’dir. Bunlar bilgi amaçlı katalog fiyatlarıdır; ödeme teklifi veya tahsilat talimatı değildir. Sitedeki para birimi tercihi API yanıtını değiştirmez. Güncel satın alma akışı için dönen hizmet adresini açın. Satın alma öncesi kullanıcının açık iznini alın; bu API satın alma işlemi sunmaz.
İstek sınırları ve hatalar
Katalog API’si IP başına dakikada 60 isteğe izin verir. Yanıtlarda yapılandırılmış RateLimit-Policy ve RateLimit başlıkları ile eski X-RateLimit başlıkları bulunur. Güncel IETF HTTPAPI taslak biçiminde r kalan hakkı, t sıfırlamaya kalan saniyeyi gösterir; t Unix zaman damgası değildir. 429 yanıtında Retry-After süresine uyup daha sonra deneyin. Desteklenmeyen veya hatalı locale değeri JSON biçiminde HTTP 422 döndürür. Yalnız GET ve HEAD desteklenir. Bayi, MCP, sipariş, ödeme veya müşteri hesabı API’si sunulmaz.
Sürümleme ve kullanımdan kaldırma politikası
Güncel kararlı API /api/v1 adresindedir. v1 içinde yeni alanlar eklenebilir; istemciler tanımadıkları yanıt alanlarını yok saymalıdır. Uyumsuz değişiklikler yeni bir ana sürüm URL’si gerektirir. Şu anda hiçbir uç kullanımdan kaldırılmamıştır ve kapanış tarihi yoktur. v1 kaldırılacaksa en az 90 gün önce bu rehberde ve llms.txt içinde tarihli duyuru yayınlanır. Etkilenen uçlarda standart Deprecation (RFC 9745), Sunset (RFC 8594) ve Link rel="deprecation" başlıkları bulunur. Gerçek kaldırma kararı öncesinde bu başlıklar gönderilmez. İstemci yükseltmelerinden önce rehberi kontrol edin.
Komut satırı istemcisi
Bağımlılık gerektirmeyen resmi Zolpix CLI, npm üzerinde zolpix-cli adıyla yayınlanır ve Node.js 22 veya üstünü kullanır. npm install -g zolpix-cli ile kurabilir veya npx zolpix-cli catalog --locale tr çalıştırabilirsiniz. Paket adresi: https://www.npmjs.com/package/zolpix-cli. https://zolpix.com/cli/zolpix.mjs dosyasını indirip inceleyin. Ardından node zolpix.mjs catalog --locale tr, node zolpix.mjs spec veya node zolpix.mjs docs --locale tr çalıştırın. Aynı salt okunur API kullanılır; satın alma gönderilemez. Katalog ve şema çıktısı JSON’dur; hatalar stderr’e yazılır. HTTP 429, Retry-After süresini bildirir ve çıkış kodu 2’dir. npm paketi ve doğrudan indirilen dosya Zolpix tarafından yayınlanır; aynı salt okunur istemciyi kullanırlar. API alan adları ve komutlar tüm dillerde aynı kalır.
Kaynaklar
- Türkçe geliştirici rehberi
- English developer guide
- Hrvatske upute za razvojne programere
- Resmi npm CLI:
npm install -g zolpix-cli. - Resmi CLI: Node.js komut satırı istemcisi.
- OpenAPI 3.1 şeması: Tipli işlem ve yanıt tanımları.
- Türkçe katalog: Salt okunur yayınlanmış katalog.
- Site haritası: Herkese açık sayfalar.
HTTP hızlı başlangıç
curl --fail-with-body --max-time 20 -H 'Accept: application/json' 'https://zolpix.com/api/v1/catalog?locale=tr'
Yanıt alanları
Başarılı yanıt locale, read_only, price_notice ve platforms alanlarını içerir. Platformlar services, hizmetler packages listelerini taşır. price_minor TRY alt birimidir; satış durumunu açıklamadan önce is_sample, purchase_mode ve live_purchase_available değerlerini kontrol edin. Tam yanıt şeması OpenAPI belgesindedir; HTTP 422 geçersiz dil, HTTP 429 ise Retry-After süresince bekleme anlamına gelir.
