API
Katalog, siparişler ve anahtarlar arayüz üzerinden
Kataloğumuzu sisteminize alın, siparişleri başlatın ve anahtarları teslim alın. Bu sayfa yolu altı adımda gösterir. Limitler, test ortamı ve sınırlar dokümantasyonda yer alır.
Bu, mağaza açılır açılmaz çalışır. O zamana kadar her şeyi rahatça okuyabilirsiniz.
Geliştirici sayfası
OpenAPI
Her çağrı bir OpenAPI 3.1 dosyasında tanımlanmıştır. Sayfalardaki her rakam, kodun uyguladığı rakamdır.
- BearerUygulama başına bir anahtar, yalnızca hash olarak saklanır, son kullanma ve yenileme ile
- JSONPara tam kuruş olarak, tarihler ISO 8601, adlar snake_case
- Dakikada 120yeni bir anahtar için okuma, anahtar 7 günlük olduğunda 600
- İmzalıİmzalı webhook'lar, isteğe bağlı olarak imzalı çağrılar da (RFC 9421)
API geliştirildi ve test edildi, dokümantasyon çevrimiçi. Anahtarlar, mağaza açılır açılmaz oluşturulabilir. Henüz yok ve yalnızca planlı: hazır bir yazılım kiti, bir ön ödemeli bakiye.
Bununla neler yapabilirsiniz
Kataloğu eşitleyin
Tüm listeyi bir kez yükleyin, sonrasında yalnızca son eşitlemenizden bu yana değişenleri. Hafif bir görünüm yalnızca stoku gösterir.
Hazır, satış başlangıcıyla açılırSipariş başlatın
Çağrı başına bir sipariş, fiyat sınırı, kendi numaranız ve çift satın almaya karşı bir anahtarla.
Hazır, satış başlangıcıyla açılırAnahtarları teslim alın
Kendine ait bir yetkiyle, sayılır ve kaydedilir. İlk çağrı, o siparişin cayma hakkını sona erdirir.
Hazır, satış başlangıcıyla açılırWebhook alın
Bir sipariş veya ürün değiştiğinde sunucunuza imzalı çağrılar. En fazla 3 adres.
Hazır, satış başlangıcıyla açılırSatıcı olarak sunun
Teklifleri, fiyatları ve stoku kendi stok sisteminizden yönetin. Bunun için Capydra üzerinde satışın açık olması gerekir.
Hazır, satış başlangıcıyla açılırYapay zeka asistanlarıyla kullanın
Aynı hesap MCP sunucumuz üzerinden de çalışır. Kurallar ve limitler aynıdır.
Hazır, satış başlangıcıyla açılır
İlk çağrıya altı adımda
- 1
Hesap oluşturun
Mağazada giriş yaparsınız.
- 2
Anahtar oluşturun
"API anahtarları" bölümünde: bir ad, rol (alıcı veya satıcı) ve ihtiyaç duyduğunuz yetkiler. Mümkün olduğunca az yetki verin.
- 3
Feragat beyanını onaylayın
Cayma hakkı hakkında iki cümle, bir kez. Anahtarla verilen her sipariş buna atıfta bulunur.
- 4
Anahtarı güvene alın
Yalnızca bir kez gösterilir. Bir parola gibi saklayın ve sunucularınızın IP adreslerini listeye ekleyin.
- 5
Günlük limit belirleyin
Bir günün tüm siparişlerinin toplamı sınırlıdır: yeni bir anahtarda €250, €5,000 tutarına kadar ayarlanabilir.
- 6
İlk çağrıyı gönderin
Anahtar "Authorization" başlığında olacak şekilde. Aşağıdaki örnek ilk ürünleri okur.
İlk çağrı
Bir anahtar omk_live_ ile başlar. Her çağrıda bearer değeri olarak gönderilir. Para tam kuruş olarak belirtilir ve hizmet bedelini içerir.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# yalnızca son eşitlemenizden bu yana değişenler
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Dokümantasyonda devam edin
Mağaza henüz açık değil: bir şeyi değiştiren çağrılar 403 showcase_mode ile yanıt verir ve yanıtlarda fiyat bulunmaz.
Sık sorulan sorular
API ne kadar tutar?
Erişim ücretsizdir. Başlattığınız siparişler için ödeme yaparsınız. Sabit ücret yoktur.
Bir yazılım kiti var mı?
Henüz yok. Dokümantasyonda curl örnekleri bulunur ve OpenAPI dosyası yaygın araçlara yüklenebilir.
Daha yüksek limitleri nasıl alırım?
Bize planınızı ve miktarınızı yazın. İhtiyacı gördüğümüz ortaklar için limitleri yükseltiriz.
Anahtarım çalınırsa ne olur?
Anahtar sayfasında iptal edin ve yenisini oluşturun. O zamana kadar günlük limit ve IP listesi zararı sınırlar. Olağandışı çağrılar anahtarı kendiliğinden dondurur.
API'deki bir hatayı nereye bildiririm?
API konusuyla iletişim formu üzerinden. Çağrıyı ve saati belirtin.
İlk çağrıya hazır mısınız?
Geliştirici sayfasını baştan sona okuyun, ardından bir anahtar oluşturun.
Talep gönderin