İ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.
| İzin | Paneldeki ad | Endpoint'ler |
|---|---|---|
store:read | Mağaza bilgisi | GET /store |
products:read | Ürünleri görme | GET /products, GET /products/{id} |
products:write | Ürün oluşturma ve düzenleme | POST /products, PATCH /products/{id}, POST /products/{id}/publish, POST /products/{id}/unpublish, POST /images |
orders:read | Siparişleri görme | GET /orders, GET /orders/{id} |
reports:read | Satış raporu | GET /reports/sales |
discount_codes:read | İndirim kodlarını görme | GET /discounts, GET /campaigns, GET /campaigns/{id}, GET /campaigns/{id}/codes, GET /discount-codes/{code} |
discount_codes:write | İndirim kodu oluşturma ve düzenleme | POST /campaigns, PATCH /campaigns/{id}, POST /campaigns/{id}/codes, PATCH /discount-codes/{code}, DELETE /discount-codes/{code} |
payment_links | Ödeme linki | POST /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.