Uygulama API'si
Kurulum ve kimlik doğrulama, /api/v1 kaynakları ve izinleri, faturalandırma, sayfalama, hatalar ve çağrı sınırı.
Bir uygulama mağazaya OAuth 2.0 yetki kodu akışıyla kurulur, bir erişim jetonu alır ve o jetonla mağazanın /api/v1 adreslerini çağırır. Go ile yazıyorsanız bunların hepsini Go SDK yapar.
Kurulum
-
Başlangıç. Mağaza sahibi yönetim panelinde uygulamayı kurmaya başlar. Platform uygulamanın
application_urladresini imzalı bir sorguyla açar:store(mağazanın ana makine adı),store_id(mağazanın sayısal kimliği) vesignature. -
Yetki isteği. Uygulama rastgele bir
stateüretir, saklar (örneğin bir çerezde) ve tarayıcıyı mağazaya gönderir:https://<mağaza>/oauth/authorize?client_id=…&scope=…&redirect_uri=…&state=…stateher zaman uygulamanındır.redirect_uri, yapılandırmadakiauth.redirect_urlsadreslerinden biriyle birebir aynı olmalıdır. -
Onay. İzin ekranı istenen izinleri listeler ve mağaza sahibi onaylar. Uygulama istediği bütün izinlerle zaten kuruluysa ekran atlanır.
-
Geri dönüş. Platform
redirect_uriadresinecode,store,statevesignatureile döner. Uygulama önce imzayı, sonrastatedeğerinin kendi sakladığı değer olduğunu denetler. -
Takas. Uygulama kodu jetona çevirir:
POST /oauth/access_token HTTP/1.1 Host: <mağaza> Content-Type: application/x-www-form-urlencoded client_id=…&client_secret=…&code=…{ "access_token": "bt_app_…", "scope": "…", "store_id": 1000000000001 }Kod bir kez çalışır ve 60 saniye sonra geçersiz olur. Hatalar:
401 invalid_client,400 invalid_grant,400 invalid_request.
Jeton uygulama kaldırılana kadar geçerlidir. Her takas yeni bir jeton verir ve kurulumun önceki jetonunu hemen iptal eder: her takastan gelen jetonu kaydedin ve her çağrıda kayıtlı olanı okuyun.
Verinizi store_id ile anahtarlayın. Mağazanın alan adı değişebilir, sayısal kimliği değişmez.
Uygulamayı açmak. Yönetim panelindeki Aç düğmesi application_url adresini 1. adımdaki imzalı sorguyla açar. İmzalı sorgu bağlantıyı platformun ürettiğini kanıtlar, bağlantıyı kimin tuttuğunu değil (5 dakika geçerlidir ve sızabilir); bu yüzden yalnızca ona bakarak kimseyi oturuma almayın. Mağaza için oturumunuz yoksa 2. adımdan OAuth'u çalıştırın: uygulama kurulu olduğu için platform doğrudan geri döner.
İmzalar
Platformun uygulamaya gönderdiği her şey uygulamanın gizli anahtarıyla (client secret) imzalıdır.
- İmzalı yönlendirmeler (1. ve 4. adım) imzayı
signaturesorgu parametresindet=<unix saniye>,v1=<hex>biçiminde taşır.v1 = hex(HMAC-SHA256(client_secret, t + "." + sorgu)); sorgu, diğer bütün parametrelerin ada göre sıralanmış ve URL kodlanmış halidir.store,store_idveyacodedeğerlerine güvenmeden önce imzayı denetleyin. - Gövdeli istekler
X-Biticaret-Signature: t=…,v1=…başlığını taşır;v1 = hex(HMAC-SHA256(client_secret, t + "." + ham gövde)). Webhook'ların imzası farklıdır: Webhook'lar. - İmzayı ham baytlar üzerinde, ayrıştırmadan önce ve sabit zamanlı karşılaştırmayla denetleyin;
tdeğeri 5 dakikadan eskiyse reddedin. - Anahtar yenileme. Gizli anahtar iş ortağı portalında yenilenir; eski anahtar seçilen süre boyunca (1 saat, 24 saat veya 7 gün) geçerli kalır. Bu sürede
X-Biticaret-Signatureher anahtar için birv1=taşır ve kod takası iki anahtarı da kabul eder.
Çağrılar
GET /api/v1/shop HTTP/1.1
Host: <mağaza>
Authorization: Bearer bt_app_…
Jetonun mağazası, isteğin gittiği mağaza olmalıdır. Yanıtlar { "data": … } biçimindedir. Kimlikler JSON sayısıdır, para kuruş cinsindendir (…_cents), zamanlar RFC 3339'dur. Gövdeli istekler Content-Type: application/json ile gönderilir.
Kaynaklar
Her adres /api/v1 altındadır. Bir yazma izni, aynı kaynağın okuma iznini de içerir (write_orders siparişleri okur). İzinlerin açıklamaları: İzinler. Koddan üretilen tam liste, hangi yolların sayfalı olduğuyla: Uygulama API'si yolları.
| Adres | İzin |
|---|---|
GET /shop |
Yok |
GET /products, GET /products/{id}, GET /products/{id}/variants |
read_products |
POST /products, PUT /products/{id}, PUT /variants/{id}/cost |
write_products |
GET /collections, GET /collections/{id} |
read_products |
PUT /variants/{id}/inventory |
write_inventory |
GET /locations |
read_locations |
GET /inventory_levels, GET /inventory_levels/history |
read_inventory |
PUT /inventory_levels, POST /inventory_levels/adjust, POST /inventory_levels/move |
write_inventory |
GET /orders, GET /orders/{id}, GET /orders/{id}/refunds |
read_orders |
PUT /orders/{id}, POST /orders/{id}/cancel, POST /orders/{id}/refunds |
write_orders |
POST /orders/{id}/fulfillments, PUT /orders/{id}/fulfillments/{fulfillmentID}, POST /orders/{id}/fulfillments/{fulfillmentID}/cancel, POST /orders/{id}/fulfillments/{fulfillmentID}/events |
write_fulfillments |
POST /orders/{id}/capture |
write_payments |
GET /customers, GET /customers/{id} |
read_customers |
GET /customer_segments, GET /customer_segments/{id}, GET /customer_segments/{id}/customers |
read_customers |
PUT /customers/{id} |
write_customers |
GET /marketing/audience |
read_marketing_audience |
POST /customers/{id}/marketing_consent |
write_marketing_consent |
GET, POST /discount_codes; GET, PUT, DELETE /discount_codes/{id} |
write_discounts |
GET /gift_cards, GET /gift_cards/{id} |
read_gift_cards |
POST /gift_cards, PUT /gift_cards/{id}, POST /gift_cards/{id}/disable |
write_gift_cards |
GET /draft_orders, GET /draft_orders/{id} |
read_draft_orders |
POST /draft_orders; PUT, DELETE /draft_orders/{id}; POST /draft_orders/{id}/complete, POST /draft_orders/{id}/send_invoice |
write_draft_orders |
GET /companies, GET /companies/{id} |
read_companies |
POST /companies; PUT, DELETE /companies/{id}; POST /companies/{id}/locations; PUT, DELETE /companies/{id}/locations/{locationID}; POST /companies/{id}/contacts; PUT, DELETE /companies/{id}/contacts/{customerID} |
write_companies |
POST /channels; GET /channels/{id}/products; PUT, DELETE /channels/{id}/products/{productID}; POST /channels/{id}/orders |
write_channels |
GET /metaobject_definitions, GET /metaobject_definitions/{id}, GET /metaobjects, GET /metaobjects/{id} |
read_metaobjects |
POST /metaobject_definitions; PUT, DELETE /metaobject_definitions/{id}; POST /metaobjects; PUT, DELETE /metaobjects/{id} |
write_metaobjects |
GET /translations |
read_translations |
PUT /translations |
write_translations |
GET, PUT /pixels/{pixelID}/settings |
write_pixels |
POST /sms, POST /sms/{id}/status |
write_sms |
GET, PUT, DELETE /metafields |
Yok (aşağıda) |
GET /webhook_deliveries, POST /webhook_deliveries/{id}/replay |
Yok |
GET /function_runs |
Yok |
GET /billing/plans; GET, POST /billing/subscriptions; GET /billing/subscriptions/{id}; POST /billing/subscriptions/{id}/cancel; POST /billing/subscriptions/{id}/usage_records; GET, POST /billing/credits |
Yok |
- Müşteri verisi düzeyi. Müşteriye ulaşabilen bir uygulama yapılandırmasında
[customer_data]bloğunda bir düzey ve gerekçe ister: 0 (müşteri verisi yok), 1 (ad ve iletişim bilgisi olmadan) veya 2 (ad ve iletişim bilgisiyle). Düzey sürüm incelemesinde onaylanır; aşağıdaki alanlar ve adresler hangi düzeyi istediklerini söyler. Onaylanandan yüksek düzey isteyen bir çağrı403 customer_data_not_approveddöner. - Ürünler (
/products) seçenekleri, varyantları ve görselleriyle gelir. Bir ürün ilk 250 varyantını sırasıyla taşır;variants_counttoplamı söyler, daha fazlası varsavariants_truncatedtrueolur veGET /products/{id}/variantshepsini sayfa sayfa verir (products/*webhook'ları da aynı biçimdedir).PUTyalnızca gönderilen alanları değiştirir;variantsgönderilirse listenin yerini alır,idtaşıyan varyant söylemediği alanları korur. Yeni bir varyantıninventory_quantitydeğeriwrite_inventoryister, var olanınki reddedilir (stok/inventory_levelsile değişir). Varyantınimage_id,compare_at_price_lawful(karşılaştırma fiyatı, bugünkü fiyattan önceki 10 günün en düşük fiyatıysa ve satış fiyatından yükseksetrue: üstü çizili "önceki fiyat" olarak yasal olarak gösterilebilir) alanları da gelir.PUT /variants/{id}/costgövdesi{"cost_cents": …}yalnızca varyantın maliyetini yazar. - Mağaza (
GET /shop) izin istemez:id,name,domain,url,primary_url(mağazanın ana alan adındaki vitrin adresi; birincil özel alan adı hazırsa o, değilseurl),email,phone,locale,currency,logo_url,logo_width,plan(handle,name) vepartner_development(geliştirme mağazasındatrue). - Müşteriler (
/customers):id,email,first_name,last_name,phone,note(satıcının müşteriye yazdığı özel not),accepts_marketing,email_marketing_consent,sms_marketing_consent,tags,orders_count,total_spent_cents,default_address,created_at,updated_at. Ad, e-posta, telefon, adres ve not müşteri verisi düzeyi 2 ister; düzey 1'de boş gelir.PUT /customers/{id}yalnızcatagsyazar; not okunur, uygulamadan değiştirilemez. - Müşteri segmentleri (
/customer_segments) mağazanın kayıtlı müşteri süzgeçleridir:id,name,rules,created_at,updated_at.GET /customer_segments/{id}/customerssegmente şu anda giren müşterileri/customersgibi, sayfalı verir. - İndirimler (
/discount_codes) kod ya da otomatik olabilir:methodcodeya daautomatictir ve yalnızca oluştururken verilir; otomatik indirimincodealanı boştur, alıcı kod yazmadan uygun her ödemede uygulanır ve sepettetitleile görünür.discount_typepercentage,fixed_amount,free_shippingya dabuy_x_get_ydir. X al Y kazan indirimindevalueY ürünlerinden düşülen yüzdedir (baz puan, 10000 bedava),applies_toY tarafıdır vebuy_x_get_y{buy_quantity, buys, get_quantity, uses_per_order}X tarafını ve adetleri verir (uses_per_ordernull ise sınırsız).combines_with{product, order, shipping}indirimin hangi sınıftaki diğer indirimlerle birlikte uygulanabileceğini söyler; çakışmada alıcıya en çok kazandıran birleşim seçilir.min_quantityen az ürün adedidir.buyer_eligibilitysegmentsolduğundacustomer_segment_idsmüşteri segmentlerinin,customersolduğundacustomer_idsseçilen müşterilerin kimlikleridir; ikisinde de yalnızca hesabıyla giriş yapmış müşteri yararlanır, misafir alıcı hiçbir segmente girmez ve hiçbir seçili müşteri sayılmaz. Müşteri verisi düzeyi 1'in altında şirket şubeleri, segmentler ve müşteriler yanıtta null gelir, gönderilirse reddedilir. - Pazarlama izni yalnızca mağazada tutulur: pazarlama uygulaması kitlesini buradan okur ve her ret kararını buraya yazar, böylece bir yerde izni geri alan müşteri her yerde geri almış olur. İki adres de müşteri verisi düzeyi 2 ister; düşük düzeyde
403 customer_data_not_approveddöner.GET /marketing/audience?channel=emailyalnızca izni açık, verilerinin silinmesini istememiş ve adresi gönderimden çıkarılmamış (kalıcı olarak geri dönen veya şikâyet eden) müşterileri, mağazanın kendi kampanyalarıyla aynı süzgeçle listeler (sayfalı):id,email,first_name,locale,consent_updated_at,source.channel=smsSMS izni açık, izni bir Türkiye cep telefonu numarası için olan ve verilerinin silinmesini istememiş müşterileri listeler;emailyerinephone(iznin verildiği numara, E.164) gelir.read_customersile gelen müşteride deemail_marketing_consentvesms_marketing_consent(state:subscribed,unsubscribedveyanot_subscribed;consent_updated_at;source; SMS'te izin açıkkenphone) bulunur.POST /customers/{id}/marketing_consentgövdesi{"channel": "email", "state": "unsubscribed"}izni her zaman geri alır."state": "subscribed"için kanıt gerekir:collected_at(müşterinin onay verdiği an, RFC 3339) veconsent_text(onaylanan metin, en çok 2000 karakter); varsaipveuser_agentde gönderin. Kanıtsız izin422 invalid_requestdöner.collected_atmüşterinin son izin değişikliğinden önceyse409 consent_superseded, müşteri verilerinin silinmesini istediyse409 erasure_requesteddöner. Kaynakapp:<uygulama>olarak kaydedilir; SMS sağlayıcı uygulaması İYS'de yapılan retleri"source": "iys"ile yazar.channel=smsaynı kanıtı ister; izin müşterinin telefonu için kaydedilir, telefon bir Türkiye cep telefonu numarası değilse422 no_mobile_numberdöner ve hiçbir şey yazılmaz; SMS izni zaten açıksa (hangi numara için olursa olsun) izin çağrısı bir şey değiştirmez. SMS izninin geri alınmasında isteğe bağlıphonegönderebilirsiniz: geri alma yalnızca bu numara hâlâ müşterinin izinli SMS numarasıysa uygulanır, değilse hiçbir şey yazılmaz vechangedfalsedöner. Numara, izin verirken olduğu gibi E.164 biçimine çevrilir;phonee-posta değişikliğinde, izin verirken ya da Türkiye cep telefonu numarası değilse422döner. SMS izni e-posta iznine, e-posta izni SMS iznine dokunmaz. Yanıt müşterinin güncel iznidir vechangedbu çağrının bir şey değiştirip değiştirmediğini söyler;Idempotency-Keybaşlığıyla tekrarlanan çağrı ilk yanıtı döner.- Her değişiklik
customers/marketing_consent_updatewebhook'u ile bildirilir (Webhook'lar).
- Meta alanlar kendi izinlerini istemez: uygulama kendi ad alanlarını her zaman okur ve yazar; bir kaynağın başka ad alanları o kaynağın iznini ister.
- Siparişler (
/orders) satırları, gönderimleri, iadeleri, indirim kodları ve satış kanalıyla gelir. Vergi KDV oranı başınatax_linesiçinde (rate_bps,base_cents,tax_cents) siparişin kaydettiği gibidir; kargo satırı kenditax_centsdeğerini taşır. Düzey 2'nin altında sipariş notu yazılmaz, korunur. - Gönderimler
write_fulfillmentsister.POST /orders/{id}/fulfillmentsline_items(line_item_id,quantity; boşsa kalan her şey), takip bilgisi venotify_customeralır. Kargo uygulaması bir gönderimi…/cancelile iptal eder (ürünler yeniden gönderilmeyi bekler) ve ilerlemesini…/eventsile bildirir:{"status": "in_transit" | "delivered" | "failed", "message": "…"}. Aynı durum ikinci kez bir şey değiştirmez, iptal edilmiş gönderime olay409döner; her yeni durum siparişin zaman çizelgesine uygulamanın adıyla yazılır. - Stok ayarlaması (
POST /inventory_levels/adjust)variant_id,location_id, işaretliamount,deny_negative(stok eksiye düşecekse409 insufficient_stock),reason(verilmezseapp;received,damaged,lostveyacorrection) ve en çok 200 karakterliknotealır.Idempotency-Keybaşlığıyla tekrarlanan çağrı ilk sonucu döner. - Stok geçmişi (
GET /inventory_levels/history) bir stok seviyesindeki her değişikliği en yeniden eskiye döner;variant_id,location_idvecreated_at_min(RFC 3339) ile daraltılır, hiçbiri verilmezse mağazanın tüm geçmişi gelir. Her satırvariant_id,location_id,delta,available_after,reason(manual,order,order_cancel,restock_refund,checkout_release,move,app,import,correction,received,damaged,lost),order_id(siparişin numarası, yoksanull),actor_type(staff,appya dasystem; kişi adı verilmez) vecreated_attaşır. Müşteri bilgisi içermez; personelin notu yalnızca yönetim panelinde görünür. - Meta nesneler (
/metaobject_definitions,/metaobjects) mağazanın kendi veri türleri ve onların kayıtlarıdır. Tanım{"metaobject_definition": {type, name, description, display_name_key, fields, web_pages, url_handle, access}}ile yazılır;typeyalnızca oluştururken verilir,PUTalanların tamamını değiştirir; bir tanım en çok 40 alan taşır. Kayıt{"metaobject": {type, handle, status, fields}}ile yazılır (statusdraftveyaactive);PUTyalnızca söylediği alanları değiştirir.GET /metaobjects?type=…bir türün kayıtlarını en yeniden eskiye verir; öteki listeler gibi sayfalanır (limit1-100, varsayılan 25,page_infoimleci veLinkbaşlığı);typezorunludur. Uygulamaya ayrılmış türler:$app:<ad>biçimindeki bir tür yalnızca onu oluşturan uygulamanındır: başka uygulamalar onu görmez (404), yalnızca sahibi değiştirir.access.admin(merchant_readveyamerchant_read_write) satıcının yönetim panelinde kayıtları yalnızca görüp göremeyeceğini,access.storefront(noneveyapublic_read) vitrinin onları okuyup okuyamayacağını söyler; verilmezse yeni türmerchant_readvenoneolur. - Çeviriler (
GET,PUT /translations)resource_typeolarakproduct,product_option,product_option_value,product_variant,collection,page,blog,article,menu,metaobjectveyalegal_templatekabul eder (tema metinlerini yalnızca yönetim paneli çevirir); başka bir tür422ve kabul edilen türlerin listesiyle döner. - Hediye kartını devre dışı bırakma:
POST /gift_cards/{id}/disablegövde okumaz; gövdesiz ya da{}ile çağrılır. Gövde gönderiyorsanızapplication/jsonolmalıdır, değilse400 invalid_jsondöner. - SMS (
write_sms):POST /smsgövdesi{"order_id": …, "body": "…"}siparişin alıcısına tek bir işlem SMS'i gönderir. Telefonu platform siparişten alır ve SMS'i mağazanın SMS sağlayıcı uygulamasına iletir; yanıt202ile{id, status, encoding, segments, …}olur, telefon ve metin dönmez. Mağazanın SMS sağlayıcısı yoksa409 no_sms_provider, siparişte cep telefonu yoksa422 no_phonedöner;Idempotency-Keybaşlığı tekrarı tek SMS yapar. SMS sağlayıcı uygulama (sms_provider = true) kendisinesms/sendile gelen SMS'in sonucunuPOST /sms/{id}/statusile bildirir:{"status": "sent" | "delivered" | "failed", "provider_message_id": "…", "error": "…"}. Başka bir uygulamanın SMS'i404döner; durum yalnızca ileri gider. - Ürün maliyeti: bir varyantın
cost_centsalanı yalnızcaread_product_costsile dolar. Vergi numarası: şahıs şirketinin 11 haneli numarası yalnızcaread_company_tax_idsile açık gelir. - Faturalandırma: aşağıda.
POST /emails(write_emails) yalnızca Biticaret'in kendi uygulamalarına açıktır.- Ödeme uygulamalarının oturum adresleri bu sayfanın konusu değildir. Ödeme uygulamaları şimdilik yalnızca Biticaret'in kendi uygulamalarıdır; üçüncü taraf ödeme uygulaması yayımlama yolu henüz açık değildir.
Faturalandırma
Uygulama mağazadan kendi ücretlendirmesini ister; izin gerekmez ve uygulama yalnızca kendi ücretlendirmelerini görür. Fiyatlar KDV hariç ve kuruş cinsindendir; KDV'yi Biticaret'in faturası ekler. Adresler yalnızca herkese açık (public) uygulamalar içindir; özel bir uygulamaya 403 billing_not_available döner.
POST /billing/subscriptionsgövdesiname,price_cents(aylık fiyat),return_urlve isteğe bağlıtrial_days,testalır. Kullanıma göre ücret içincapped_amount_cents(aylık üst sınır) veusage_termsekleyin; ikisinden (aylık fiyat veya kullanım satırı) en az biri gerekir.testücretlendirme hiç faturalanmaz.- Yanıttaki
confirmation_urladresine satıcının tarayıcısını gönderin; satıcı yönetim panelinde onaylar veya reddeder, tarayıcıreturn_url?charge_id=<id>adresine döner. - Durum değişiklikleri
app_subscriptions/updatewebhook'uyla gelir:pending,active,declined,cancelled,frozen(mağazanın faturası ödenmedi veya uygulama askıya alındı; sonra yenidenactive),expired(satıcı 2 gün içinde karar vermedi) vescheduled(yıllık bir planın yılı bitince başlayacak plan,starts_at). POST /billing/subscriptions/{id}/usage_records{description, price_cents, idempotency_key}ile kullanım ücreti yazar; ay içindeki toplamcapped_amount_centsdeğerini aşamaz.balance_used_centsbu ayki kullanımdır.
Planlar. Uygulama planlarını iş ortağı portalında tanımlarsa (yönetilen fiyatlandırma) satıcı planını uygulamanın plan sayfasında seçer; GET /billing/plans fiyatlandırma biçimini ve mağazanın seçebileceği planları verir. Bir plan aylık (interval monthly, ay sonunda faturalanır) ya da yıllık (annual, her plan yılının başında faturalanır) olabilir ve bir kullanım satırı taşıyabilir. Plandan gelen ücretlendirmede plan alanı doludur; uygulamanın kendi oluşturduğu ücretlendirme her zaman aylıktır. Yönetilen fiyatlandırmadaki bir uygulamanın POST /billing/subscriptions çağrısı 409 managed_pricing döner. GET, POST /billing/credits uygulamanın mağazaya verdiği alacakları okur ve yazar.
Sayfalama
Liste adresleri limit alır (1 ile 100 arası, varsayılan 25) ve en yeniden eskiye döner. Yanıt bir sonraki sayfanın imlecini hem gövdede hem Link başlığında taşır:
Link: <…?limit=25&page_info=…>; rel="next"
{ "data": [], "page_info": { "next": "…", "previous": null } }
Sonraki sayfa için page_info değerini olduğu gibi geri gönderin; imleç opaktır.
Hatalar
Hatalar HTTP durumu ve şu gövdeyle gelir:
{ "error": { "code": "…", "message": "…" } }
code sabittir ve kod içindir; message insanlar içindir ve değişebilir.
| Durum | Kod | Ne zaman |
|---|---|---|
400 |
invalid_json |
Gövde beklenen biçimde JSON değil veya application/json olarak gönderilmedi. |
401 |
invalid_token |
Jeton yok, bilinmiyor, iptal edilmiş veya başka bir mağazanın. |
403 |
missing_scope |
Jetonda adresin istediği izin yok. |
404 |
not_found |
Bu mağazada bu uygulama için böyle bir kaynak yok. |
403 |
customer_data_not_approved |
Adres veya alan, uygulamanın onaylanmış müşteri verisi düzeyinden yükseğini istiyor. |
409 |
conflict ve adrese özgü kodlar |
İstek kaynağın şimdiki haliyle çelişiyor (inventory_changed, insufficient_stock, consent_superseded gibi). |
422 |
invalid_request |
Biçimi doğru ama platformun kabul etmediği bir istek. |
422 |
idempotency_key_reused |
Aynı Idempotency-Key başka bir istekle kullanıldı. |
423 |
store_suspended |
Mağaza askıya alındı; açık ödeme oturumlarının sonuçları dışında her çağrı reddedilir. |
429 |
rate_limited |
Çağrı sınırı doldu; Retry-After kadar bekleyin. |
503 |
store_moving |
Mağaza birkaç dakikalığına başka bir sunucuya taşınıyor: okumalar çalışır, yazmalar ve kod takası Retry-After kadar sonra yeniden denenmelidir. |
5xx |
internal_error |
Platform başarısız oldu; aynı çağrı sonra başarılı olabilir. |
400, 409 ve 422 isteğin kendisini reddeder: yeniden göndermek aynı yanıtı verir.
Çağrı sınırı
Her kurulumun bir kovası vardır: her çağrı bir ekler, kova saniyede 2 boşalır ve 40 çağrı alır. Bilinen bir jetona verilen her yanıt kovanın durumunu söyler:
X-Biticaret-Api-Call-Limit: 14/40
Kova doluyken yanıt 429 rate_limited ve saniye cinsinden Retry-After olur.