CIQRA mağazaları için uygulama geliştirin

Bir CIQRA uygulaması, CIQRA API üzerinden tek bir mağazayla konuşan kendi servisinizdir. Mağaza sahibi onu kurar, neler yapabileceğini seçer ve istediği an kaldırabilir. Uygulamanız bir client id ve secret alır, bunları kısa ömürlü bir token ile değiştirir ve API’yi mağazanın kendi alan adı üzerinden çağırır.

13uygulama token'ının çağırabildiği işlem

9 / 52bir endpoint'in uyguladığı scope

999platform API'sindeki toplam işlem

Bu sayılar, site her derlendiğinde platformun API sözleşmesinden sayılarak üretilir. Aynısı App API referansı ve scope tablosu için de geçerlidir: bu sayfalarda elle yazılmış hiçbir şey yoktur; bir endpoint uygulamalara açıldığında bir sonraki derlemede burada görünür.

Nereden başlamalı

Hızlı başlangıçKimlik bilgilerinden ilk API çağrınıza dört istekte.

Bir uygulama nereye otururUygulamalar, kurulumlar, token'lar ve mağazalar — dört temel kavram.

App API referansıBir uygulamanın çağırabileceği her işlem, istek ve yanıt şemalarıyla birlikte.

Webhook'larMağaza olaylarına abone olun ve CIQRA'dan geldiklerini doğrulayın.

Söz vermeden önce okumanız gerekenler

API varsayılan olarak kapalıdır: bir endpoint, ancak açıkça bir scope (yetki) ile açıldıktan sonra uygulama token’larını kabul eder. Bugün bu kapsamda ürün kataloğu, koleksiyonlar, stok seviyeleri, medya içe aktarımları, metaobject’ler ve webhook abonelikleri var. Siparişler, müşteriler, fiyatlar ve diğer alanların çoğu henüz uygulamalara açık değildir, scope’ları şimdiden verilebiliyor olsa bile. Uygulamaların henüz yapamadıkları sayfası, planlamanızı bunlara göre yapmadan önce bilinen kusurlar dahil tüm eksikleri listeler.

Dil

CIQRA’da tüccara gösterilen metinler — örneğin onay ekranındaki scope açıklamaları — Türkçedir. Burada birebir gösterilir, çünkü tüccarın uygulamanızı kurarken okuduğu metin budur.

Ekip dokümantasyonu

CIQRA mühendisleri: platform API’sinin tamamı, veritabanı modeli ve modül haritası iç dokümantasyonda (parola gerekir).