Mağaza API'si
Mağazanızı okuyun; ürünleri, ödeme alma linklerini ve indirimleri kendi sunucunuzdan, izinli API anahtarlarıyla yönetin.
Mağaza API'si, kendi yazılımınızın ve otomasyon araçlarınızın hikie mağazanızı yönetmesini sağlar: siparişleri ve satışları okuyun, ürün oluşturup yayına alın, ödeme alma linki üretin. HTTPS üzerinden çalışan bir JSON API'sidir.
Temel adres: https://api.hikie.space/v1Anahtarları sunucunuzda tutun. Tarayıcı kodunuza, mobil uygulamaya ya da herkese açık bir depoya koymayın.
Nasıl çalışır
- Mağaza API anahtarıyla (
hks_…) kimlik doğrularsınız; anahtarı Bearer olarak gönderirsiniz. - Bir anahtar tek bir mağazaya aittir. Hiçbir istekte mağaza kimliği yoktur; hangi mağazada işlem yaptığınızı anahtar belirler.
- Her anahtar, oluştururken seçtiğiniz izinleri taşır. Anahtar yalnızca izinlerinin açtığı endpoint'leri çağırabilir.
- Bir şey oluşturan ya da değiştiren istekler
Idempotency-Keytaşır; ağ hatasından sonra yaptığınız tekrar, değişikliği iki kez uygulamaz.
Hızlı başlangıç
Anahtar oluşturun
Panelde Ayarlar → API Anahtarları sayfasını açın ve Yeni anahtar'ı seçin. Ad verin, yalnızca entegrasyonun ihtiyaç duyduğu izinleri işaretleyin ve anahtar göründüğünde kopyalayın. Yalnızca bir kez gösterilir. Bkz. Anahtarlar.
İlk çağrıyı yapın
curl https://api.hikie.space/v1/store \
-H "Authorization: Bearer hks_..."Anahtarın store:read izni olmalı.
Ürün oluşturup yayına alın
curl -X POST https://api.hikie.space/v1/products \
-H "Authorization: Bearer hks_..." \
-H "Idempotency-Key: rehber-2026-11-001" \
-H "Content-Type: application/json" \
-d '{"name":"Lansman rehberi","price":149.9,"vatRate":20,"paymentType":"one-off","shipmentAdressCollected":false}'Ürün taslak olarak başlar. Yayına alma dahil akışın devamı için bkz. Ürünler.
Alıcıyı ödemeye gönderin
POST /v1/payment-links, yayındaki bir ürünü e-postaya ya da mesaja
koyabileceğiniz bir linke çevirir. Linkleri listeleyip silebilirsiniz de. Bkz.
Ödeme alma linkleri.
API'de neler var
| Alan | Ne yapabilirsiniz | Sayfa |
|---|---|---|
| Anahtarlar | İzinli anahtar oluşturma, bitiş tarihi ve istek sınırı belirleme, yenileme ve iptal | Anahtarlar |
| İzinler | Hangi izin hangi ucu açar | İzinler |
| İstekler | İstek sınırları, Idempotency-Key ile tekrar, tarih ve sayfalama | İstekler ve sınırlar |
| Okuma | Mağaza, ürünler, siparişler, satış raporu, indirimler | Okuma işlemleri |
| Ürünler | Ürün oluşturma, düzenleme, yayına alma ve yayından kaldırma, görsel yükleme | Ürünler |
| Ödeme alma linkleri | Bir dijital ürün için ödeme alma linki oluşturma, listeleme ve silme | Ödeme alma linkleri |
| İndirimler | Tekil kodlu kampanyalar ve kodlar | İndirimler |
| Hatalar | Hata biçimi ve tüm hata kodları | Hatalar |
| Sürümleme | Neyin kırıcı değişiklik sayıldığı ve nasıl duyurulduğu | Sürümleme |
Bu sürümde olmayanlar
İade, para çekme, banka bilgisi, üye silme, abonelik iptali, ekip yönetimi ve ders içeriği düzenleme API üzerinden yapılamaz. Müşterinin e-postası, telefonu ve adresi hiçbir zaman döndürülmez: sipariş yanıtları bunları içermez.
Yapay zekâ asistanları ve otomasyon araçları için
Bu sayfadaki her şey makinenin okuyabileceği biçimde de yayımlanır. Aracınızı bu dosyalardan birine yönlendirin.
| Dosya | İçerik |
|---|---|
/openapi.yaml | Mağaza API'sinin tamamı, OpenAPI 3.1 tarifi olarak |
/llms.txt | Dokümantasyonun içindekiler listesi; her sayfanın sade metin sürümüne bağlantı verir |
/store-api.txt | Mağaza API'sinin bütün sayfaları tek bir sade metin dosyasında |
/llms-full.txt | Tüm dokümantasyon sayfaları tek bir sade metin dosyasında |
Herhangi bir sayfa adresinin sonuna .md ekleyerek sade metin sürümünü alırsınız;
örneğin /docs/store-api/keys.md. Türkçe için yukarıdaki her adresin başına
/tr koyun, örneğin /tr/llms.txt ve /tr/docs/store-api/keys.md
(/openapi.yaml iki dil için aynıdır).