hikiehikieDeveloper Documentation
Genel bakış

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/v1

Anahtarları 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-Key taşı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

AlanNe yapabilirsinizSayfa
Anahtarlarİzinli anahtar oluşturma, bitiş tarihi ve istek sınırı belirleme, yenileme ve iptalAnahtarlar
İzinlerHangi izin hangi ucu açarİzinler
İsteklerİstek sınırları, Idempotency-Key ile tekrar, tarih ve sayfalamaİstekler ve sınırlar
OkumaMağaza, ürünler, siparişler, satış raporu, indirimlerOkuma 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 linkleriBir dijital ürün için ödeme alma linki oluşturma, listeleme ve silmeÖdeme alma linkleri
İndirimlerTekil kodlu kampanyalar ve kodlarİndirimler
HatalarHata biçimi ve tüm hata kodlarıHatalar
SürümlemeNeyin kırıcı değişiklik sayıldığı ve nasıl duyurulduğuSü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.yamlMağaza API'sinin tamamı, OpenAPI 3.1 tarifi olarak
/llms.txtDokümantasyonun içindekiler listesi; her sayfanın sade metin sürümüne bağlantı verir
/store-api.txtMağaza API'sinin bütün sayfaları tek bir sade metin dosyasında
/llms-full.txtTü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).

Bu sayfada