hikiehikieDeveloper Documentation
Hatalar

Hatalar

Mağaza API'sinin hata biçimi ve döndürdüğü tüm hata kodları.

Bir hata yanıtı şöyle görünür:

{ "status": 409, "message": "Yalnızca yayındaki ürün için ödeme linki oluşturulabilir.", "errorCode": "PRODUCT_NOT_PUBLISHED" }

HTTP durumuna ve errorCode'a göre dallanın. message Türkçedir ve değişebilir. Bazı hatalarda errorCode yoktur: doğrulamadan geçemeyen bir istek gövdesi (tanımsız alan, yanlış tür, aralık dışı değer) yalnızca status ve message ile 400 döner.

Kimlik doğrulama ve erişim

DurumerrorCodeAnlamı
401API_KEY_MISSINGAuthorization: Bearer başlığı yok
401API_KEY_INVALIDBilinmeyen anahtar ya da gizli değer yenilenmiş
401API_KEY_REVOKEDAnahtar iptal edilmiş
401API_KEY_EXPIREDAnahtarın bitiş tarihi geçmiş
403API_PERMISSION_DENIEDAnahtarın bu ucun istediği izni yok. Mesaj izni belirtir
403API_ACCESS_NOT_APPROVEDGeliştirici erişimi onaylanmadan bir indirim ucu çağrıldı
403STORE_INACTIVEMağaza aktif değil
403STORE_NOT_VERIFIEDÜrünü yayına almak ya da ödeme alma linki oluşturmak için mağaza doğrulanmış olmalı
429RATE_LIMIT_EXCEEDEDAnahtarın izin verdiğinden fazla istek. Retry-After başlığına bakın

Tekrar

DurumerrorCodeAnlamı
400IDEMPOTENCY_KEY_REQUIREDIdempotency-Key olmadan yapılan bir POST
400IDEMPOTENCY_KEY_INVALIDAnahtar boş ya da 255 karakterden uzun
409IDEMPOTENCY_IN_PROGRESSBu anahtarla yapılan ilk istek hâlâ sürüyor
422IDEMPOTENCY_KEY_REUSEDAnahtar daha önce farklı bir istek için kullanılmış

Okuma

DurumerrorCodeAnlamı
400DATE_RANGE_INVALIDTarih hatalı, from, to'dan önce değil ya da rapor aralığı 1100 günden uzun
400PAGE_TOO_DEEPGET /products'ta page × limit 5000'den büyük
404STORE_NOT_FOUNDMağaza yok
404PRODUCT_NOT_FOUNDMağazanızda böyle bir ürün yok
404ORDER_NOT_FOUNDMağazanızda böyle bir sipariş yok
404PAYMENT_LINK_NOT_FOUNDMağazanızda böyle bir ödeme alma linki yok ya da silinmiş

Ürünler ve görseller

DurumerrorCodeAnlamı
400STOCK_NOT_ALLOWEDshipmentAdressCollected: true olmadan stock gönderildi
400EMPTY_UPDATEDeğiştirilecek bir şey olmayan PATCH
400PRODUCT_CREATE_FAILEDÜrün oluşturulamadı. Aynı Idempotency-Key ile tekrar denemek güvenlidir
400PAYMENT_TYPE_NOT_ALLOWEDshipmentAdressCollected: true ile birlikte recurring / free
400PRICE_REQUIREDÜcretli üründe geçerli price yok
400PRICE_NOT_ALLOWEDfree üründe price verilmiş
400RECURRING_FIELDS_REQUIREDrecurring iken dört tekrarlayan alandan biri eksik
400RECURRING_FIELDS_NOT_ALLOWEDone-off ya da free üründe tekrarlayan alan verilmiş
400PAYMENT_PERIOD_NOT_SUPPORTEDweekly ya da day / week cinsinden süre
400INVALID_PAYMENT_PERIODpaymentPeriodCount, periyodun sınırını aşıyor
400INVALID_DURATIONToplam süre tahsilat periyodunun tam katı değil ya da 120 ay / 60 tahsilatı aşıyor
400IMAGE_REQUIREDYüklemede file alanı yok
400IMAGE_TOO_LARGEGörsel 10 MB'dan büyük
400IMAGE_TYPE_NOT_ALLOWEDDosya JPEG, PNG ya da WebP değil
400IMAGE_URL_NOT_ALLOWEDBir görsel adresi POST /images ile yüklenmemiş
400IMAGE_DUPLICATEAynı görsel adresi iki kez var
400IMAGE_STORAGE_UNAVAILABLEGörsel depolama şu anda kullanılamıyor. Sonra tekrar deneyin
409PRODUCT_NOT_READYFiyatı olmayan ürün ya da stoğu olmayan fiziksel ürün yayına alınamaz
409PRODUCT_HAS_VARIANTSÜrünün birden çok varyantı var; API bunları fiyatlayamaz ya da linkleyemez
409PRICE_CHANGE_NOT_ALLOWEDAbonelikli dijital ürünün fiyatı API ile değiştirilemez
409DISCOUNT_EXCEEDS_PRICEYeni fiyat, ürünün indirimli fiyatının üzerinde değil
429DAILY_LIMIT_REACHEDYeni ürün (50) ya da görsel yükleme (300) günlük sınırına ulaşıldı. Türkiye saatiyle gece yarısı sıfırlanır

Ödeme alma linkleri

DurumerrorCodeAnlamı
400EXPIRES_AT_INVALIDÖdeme alma linkinin expiresAt değeri gerçek bir tarih değil, geçmişte ya da 365 günden ilerde
409PRODUCT_TYPE_NOT_SUPPORTEDFiziksel ürün ya da eski tip dijital ürün için ödeme alma linki istendi; yalnızca dijital ürünlere (type: "membership") verilebilir
409PRODUCT_NOT_PUBLISHEDDijital ürün satışta değil

İndirim kodları

Kampanya ve kod endpoint'leri yukarıdaki ortak hataları ve şunları kullanır:

DurumerrorCodeAnlamı
404CAMPAIGN_NOT_FOUNDMağazanızda bu kimlikle tekil kodlu kampanya yok
400DISCOUNT_CODE_INVALID_FORMATKod 8–40 karakter A–Z, 0–9, - değil ya da 24 haneli hex
400DISCOUNT_CODE_INVALID_RULEBir değer, sınır ya da tarih geçersiz
404DISCOUNT_CODE_NOT_FOUNDBöyle bir kod yok
409DISCOUNT_CODE_IN_USEKullanılmış ya da ödemesi süren kod silinemez; isActive: false gönderin
502UPSTREAM_UNAVAILABLEKampanya şu anda kaydedilemedi. Tekrar denemeden önce kampanyalarınızı listeleyin — ilk deneme başarılı olmuş olabilir
400STORE_NOT_CONFIGUREDMağazanızın kurulumu tamamlanmamış; destekle iletişime geçin

Doğrulamayı geçemeyen kampanya (örneğin 100'ü aşan yüzde) 400 ve bir message ile döner.

Şu kodları alıcı ödeme sırasında görür; API üzerinden size dönmez: DISCOUNT_CODE_EXPIRED, DISCOUNT_CODE_EXHAUSTED, DISCOUNT_CODE_INACTIVE, DISCOUNT_CODE_NOT_APPLICABLE, DISCOUNT_CODE_CURRENCY, DISCOUNT_CODE_NOT_COMBINABLE.

Diğer durumlar

DurumAnlamı
errorCode olmadan 404Böyle bir yol yok
5xxhikie tarafında bir sorun. Aynı Idempotency-Key ile tekrar deneyin; sürerse destekle iletişime geçin

Bu sayfada