hikiehikieDeveloper Documentation
Başlangıç

İzinler

Her endpoint için anahtarın hangi izne sahip olması gerektiği.

Her endpoint tam olarak bir izin ister. Bu izni taşımayan anahtar 403 API_PERMISSION_DENIED alır. İzinler anahtar oluşturulurken seçilir ve sonra değişmez; değiştirmek için yeni anahtar oluşturun.

İzinPaneldeki adEndpoint'ler
store:readMağaza bilgisiGET /store
products:readÜrünleri görmeGET /products, GET /products/{id}
products:writeÜrün oluşturma ve düzenlemePOST /products, PATCH /products/{id}, POST /products/{id}/publish, POST /products/{id}/unpublish, POST /images
orders:readSiparişleri görmeGET /orders, GET /orders/{id}
reports:readSatış raporuGET /reports/sales
discount_codes:readİndirim kodlarını görmeGET /discounts, GET /campaigns, GET /campaigns/{id}, GET /campaigns/{id}/codes, GET /discount-codes/{code}
discount_codes:writeİndirim kodu oluşturma ve düzenlemePOST /campaigns, PATCH /campaigns/{id}, POST /campaigns/{id}/codes, PATCH /discount-codes/{code}, DELETE /discount-codes/{code}
payment_linksÖdeme linkiPOST /payment-links, GET /payment-links, GET /payment-links/{id}, DELETE /payment-links/{id}

discount_codes:write izni discount_codes:read iznini içermez. Kampanya oluşturup geri okuyan bir anahtarın ikisine de ihtiyacı vardır.

Geliştirici erişimi

İndirim endpoint'leri (/discounts, /campaigns…, /discount-codes…) bir şey daha ister: geliştirici erişiminizin onaylanmış olması. Ayarlar → Webhooklar sayfasından başvurun; aynı onay hem webhook'ları hem bu endpoint'leri kapsar. Onaylanana kadar panel iki indirim iznini işaretlemenize izin vermez ve endpoint'ler 403 API_ACCESS_NOT_APPROVED döner.

Diğer tüm endpoint'ler bu onay olmadan çalışır.

Mağaza doğrulaması

Ürünü yayına almak ve ödeme alma linki oluşturmak için mağazanızın doğrulanmış olması gerekir. Okuma ve taslak oluşturma her mağazada çalışır. Bkz. Ürünler ve Ödeme alma linkleri.

İzin seçme

Anahtara gereken en az izni verin:

  • Raporlama aracı: reports:read, orders:read.
  • Katalog senkronu: products:read, products:write.
  • Ödeme alma linki gönderen bir müşteri destek botu: products:read, payment_links.

Her entegrasyon için ayrı anahtar kullanmak, bir değişikliği kimin yaptığını da anahtarın adından anlamanızı sağlar: hikie, başarılı her değişikliği onu yapan anahtarla birlikte kaydeder.

Bu sayfada