hikiehikieDeveloper Documentation
Sürümleme

Değişiklik günlüğü

Mağaza API'sindeki değişiklikler, en yeniden eskiye. Kırıcı değişiklikler yürürlüğe girmeden önce burada duyurulur.

Değişiklikler en yeniden eskiye listelenir. Kırıcı bir değişiklik, yürürlüğe girmesinden en az 90 gün önce burada duyurulur; bkz. Sürümleme.

18 Kasım 2026

  • Teslimat adresi toplanmayan ürün artık her zaman dijital ürün açar. POST /products isteğinde shipmentAdressCollected: false ve paymentType: "one-off" gönderildiğinde artık eski tip dijital ürün (type: "digital") değil, tek seferlik bir dijital ürün (type: "membership") açılır. API eski tipi açmaz. Panelde daha önce açılmış eski tip dijital ürünler okunmaya ve düzenlenmeye devam eder.

v1 — ilk sürüm

Mağaza API'si https://api.hikie.space/v1 adresindedir.

  • Anahtarlar. Mağaza başına birden çok anahtar; her birinin kendi adı, izinleri, isteğe bağlı bitiş tarihi ve istek sınırı var. Tek tek yenilenir ve iptal edilir. İlk tek anahtar, indirim kodları ve Yazılım modülü lisansları için çalışmaya devam eder.
  • Okuma. GET /store, GET /products, GET /products/{id}, GET /orders, GET /orders/{id}, GET /reports/sales ve GET /discounts. Müşterinin e-postası, telefonu ve adresi döndürülmez.
  • Ürünler. Fiziksel ürünler ve dijital ürünler için POST /products, PATCH /products/{id}, POST /products/{id}/publish, POST /products/{id}/unpublish ve POST /images. type alanı yoktur; türü zorunlu shipmentAdressCollected ve paymentType alanları belirler: true fiziksel ürün açar (yalnızca tek seferlik); false iken dijital ürün (type: "membership") açılır: tek seferlik, recurring (aylık ya da yıllık tahsilat; paymentPeriod, paymentPeriodCount, durationInCycleCount ve durationInCyclePeriod alanlarıyla) ya da free. Fiyatlara tüm vergiler dahildir; vatRate zorunludur.
  • Ödeme alma linkleri. POST /payment-links, GET /payment-links, GET /payment-links/{id} ve DELETE /payment-links/{id}; dijital ürünler için. Linke kullanım limiti (maxUses, isMaxUsesApplied ile bildirilir) ve özel bitiş zamanı (expiresAt, varsayılan 30 gün) verilebilir.
  • Tekrar. POST isteklerinde Idempotency-Key ve anahtar başına istek sınırı başlıkları.
  • Makinenin okuyabildiği dokümantasyon. /openapi.yaml, /llms.txt, /llms-full.txt ve her sayfanın sade metin sürümü.

Bu sürümdeki bilinen sınırlar: haftalık ve günlük tahsilat döngüsü yok, GET /products ve GET /products/{id} fiziksel ürünleri döndürmez ve müşteri bilgileri API üzerinden alınamaz.

Bu sayfada