Xəta kodları

API heç vaxt tərcümə olunmuş mətn qaytarmır. Hər uğursuzluq sabit maşınoxunan kodu olan JSON zərfidir; həmin kodu öz mətnlərinizə uyğunlaşdırırsınız.

Zərf

statusCode HTTP statusunu təkrarlayır, code sabit identifikatordur, message istənilən vaxt dəyişə bilən ingiliscə developer ipucudur, details isə bəzi kodlar üçün struktur kontekst daşıyır (məsələn hansı məhsulların anbarda olmadığı).

application/json

{
  "statusCode": 409,
  "code": "ERR_OUT_OF_STOCK",
  "message": "insufficient stock for 2 items",
  "details": { "items": [{ "productId": "…", "requested": 5, "available": 2 }] }
}

code üzrə uyğunlaşdırın, heç vaxt message üzrə yox

message loqu oxuyan insan üçün yazılıb. O, müqavilənin hissəsi deyil və tərcümə olunmur; code isə müqavilənin hissəsidir.

Kataloq

98 kod

Ümumi

Ümumi
Kod	Mənası
`ERR_VALIDATION`	Sorğunun gövdəsi və ya sorğu parametrləri validasiyadan keçmədi; details problemli sahələri sadalayır.
`ERR_BAD_REQUEST`	Sorğu validasiyanın təsvir edə bilmədiyi şəkildə səhvdir.
`ERR_UNAUTHORIZED`	Etimadnamə göndərilməyib və ya access token-in vaxtı bitib.
`ERR_FORBIDDEN`	Autentifikasiya olunub, lakin bu əməliyyata icazəniz yoxdur.
`ERR_NOT_FOUND`	Resurs mövcud deyil və ya sizə görünmür.
`ERR_CONFLICT`	Yazma paralel əməliyyatla toqquşdu; sorğunu təkrarlayın.
`ERR_RATE_LIMITED`	Bu açar üçün çox sorğu. Retry-After-dakı saniyə qədər gözləyin.
`ERR_INTERNAL`	Gözlənilməz server xətası. Geri çəkilmə ilə təkrarlamaq təhlükəsizdir.
`ERR_NETWORK`	Sorğu API-yə çatmadı (şəbəkə, DNS və ya CORS).
`ERR_UNKNOWN`	Tanınmayan xəta; xam cavaba baxın.

Autentifikasiya və hesablar

Autentifikasiya və hesablar
Kod	Mənası
`ERR_OTP_INVALID`	Birdəfəlik kod uyğun gəlmir.
`ERR_OTP_EXPIRED`	Birdəfəlik kodun vaxtı bitib; yenisini istəyin.
`ERR_OTP_RATE_LIMITED`	Bu nömrə və ya e-poçt ünvanı üçün çox kod istəyi olub.
`ERR_OTP_TOO_MANY_ATTEMPTS`	Çox səhv kod daxil edilib; yenisini istəyin.
`ERR_USER_BLOCKED`	Hesab bloklanıb; ona aid bütün tokenlər rədd edilir.
`ERR_STAFF_PHONE_EXISTS`	Bu telefon nömrəsi ilə istifadəçi artıq var.
`ERR_PHONE_REQUIRED`	Bu hesabın əlaqə telefon nömrəsi yoxdur — sifarişdən əvvəl əlavə edin.
`ERR_CONTACT_TAKEN`	Bu telefon nömrəsi və ya e-poçt ünvanı artıq başqa hesaba aiddir.
`ERR_CHANNEL_DISABLED`	Bu giriş üsulu burada söndürülüb — digərindən istifadə edin.

Partnyor API, açarlar və vebhuklar

Partnyor API, açarlar və vebhuklar
Kod	Mənası
`ERR_API_KEY_INVALID`	X-Api-Key başlığı yoxdur və ya heç bir açara uyğun gəlmir.
`ERR_API_KEY_REVOKED`	Açar ləğv edilib və ya rotasiya güzəşt müddəti bitib.
`ERR_API_KEY_SCOPE`	Açar etibarlıdır, lakin bu endpointin tələb etdiyi scope-u daşımır.
`ERR_API_KEY_ENVIRONMENT`	Sandbox açarı canlı API-yə göndərilib və ya əksinə.
`ERR_API_KEY_LIMIT`	Artıq maksimum sayda aktiv açarınız var.
`ERR_WEBHOOK_URL_INVALID`	Endpoint URL https olmalıdır (http yalnız produksiyadan kənar localhost üçün mümkündür).
`ERR_WEBHOOK_LIMIT`	Bu açarda artıq maksimum sayda vebhuk var.
`ERR_WEBHOOK_DISABLED`	Bu webhook söndürülüb — sınaq göndərməzdən əvvəl onu yenidən aktiv edin.
`ERR_PARTNER_ORDER_NOT_ASSIGNED`	Sifariş sizin partnyor hesabınıza təyin olunmayıb.

Ödənişlər

Ödənişlər
Kod	Mənası
`ERR_PAYMENT_METHOD_UNAVAILABLE`	Bu ödəniş üsulu həmin mühitdə deaktivdir.
`ERR_PAYMENT_PROVIDER_UNAVAILABLE`	Kart provayderi konfiqurasiya olunmayıb və ya cavab vermədi.
`ERR_PAYMENT_INTENT_INVALID_STATE`	Ödəniş niyyəti bu əməliyyata icazə verən statusda deyil.
`ERR_PAYMENT_SIGNATURE_INVALID`	Provayder vebhukunun imzası doğrulanmadı.
`ERR_PAYMENT_ALREADY_PAID`	Sifariş artıq ödənilib.

Sifarişlər

Sifarişlər
Kod	Mənası
`ERR_NO_DEFAULT_ADDRESS`	Müştərinin default çatdırılma ünvanı yoxdur.
`ERR_OUT_OF_STOCK`	Bir və ya bir neçə sətir mövcud anbardan çoxdur; details onları sadalayır.
`ERR_PRODUCT_UNAVAILABLE`	Sifarişdəki məhsul artıq satışda deyil.
`ERR_OUT_OF_ZONE`	Çatdırılma ünvanı bütün aktiv zonaların xaricindədir.
`ERR_ORDER_NOT_CANCELLABLE`	Sifariş ləğv edilə biləcəyi mərhələni keçib.
`ERR_ORDER_NOT_RATABLE`	Yalnız çatdırılmış sifarişi qiymətləndirmək olar.
`ERR_ALREADY_RATED`	Bu sifariş artıq qiymətləndirilib.
`ERR_INVALID_TRANSITION`	Sifariş vəziyyət maşını cari statusdan bu keçidi rədd edir.
`ERR_IDEMPOTENCY_KEY_REQUIRED`	Bu yazma Idempotency-Key başlığı tələb edir.
`ERR_IDEMPOTENCY_CONFLICT`	Eyni Idempotency-Key fərqli gövdə ilə təkrar istifadə olunub.
`ERR_ORDER_NOT_ACCEPTABLE`	Sifariş satıcının qəbul və ya rədd edə biləcəyi statusda deyil.
`ERR_ORDER_ALREADY_CLAIMED`	Bu sifarişi artıq başqa kuryer götürüb.
`ERR_ORDER_NOT_CLAIMED`	Sifariş sizin tərəfinizdən götürülməyib.
`ERR_ORDER_NOT_PACKABLE`	Sifariş qablaşdırıla, yenidən qablaşdırıla və ya çap edilə biləcək vəziyyətdə deyil.

Kataloq və satıcılar

Kataloq və satıcılar
Kod	Mənası
`ERR_VENDOR_NOT_FOUND`	Bu istifadəçi və ya id üçün satıcı profili yoxdur.
`ERR_ITEMS_ALREADY_DECIDED`	Bu sifariş sətirləri artıq qəbul və ya rədd edilib.
`ERR_PRODUCT_NOT_OWNED`	Məhsul başqa satıcıya aiddir.
`ERR_CATEGORY_INVALID`	Kateqoriya id-si tanınmır və ya son səviyyə kateqoriya deyil.
`ERR_SKU_CONFLICT`	Yaradılan SKU mövcud biri ilə toqquşdu.
`ERR_MEDIA_UNAVAILABLE`	Obyekt anbarı konfiqurasiya olunmayıb və ya əlçatan deyil.
`ERR_MEDIA_INVALID`	Yükləmə rədd edildi: yanlış məzmun tipi və ya həddindən böyük.
`ERR_CATEGORY_NOT_EMPTY`	Kateqoriyada hələ məhsullar və ya alt kateqoriyalar var.
`ERR_CATEGORY_CYCLE`	Bu köçürmə kateqoriyanı öz əcdadına çevirərdi.

Dispetçerlik və çatdırılma

Dispetçerlik və çatdırılma
Kod	Mənası
`ERR_PICKUP_INCOMPLETE`	Qəbul edilmiş bütün məhsullar hələ yığılmayıb.
`ERR_ITEM_NOT_PICKABLE`	Bu məhsul yığıla biləcək statusda deyil.
`ERR_DRIVER_NOT_FOUND`	Bu istifadəçi üçün sürücü profili yoxdur.
`ERR_DRIVER_OFFLINE`	Sürücü onlayn deyil, ona görə paket təklif edilə bilməz.
`ERR_DRIVER_BUSY`	Sürücünün artıq aktiv paketi var.
`ERR_BATCH_NOT_OFFERED`	Paket hazırda bu sürücüyə təklif olunmayıb.
`ERR_OFFER_EXPIRED`	90 saniyəlik qəbul pəncərəsi bitib.
`ERR_BATCH_NOT_ASSIGNED`	Paket bu sürücüyə təyin olunmayıb.
`ERR_SCAN_INCOMPLETE`	Skan qapısı yola düşməyi rədd etdi: bütün məhsullar skan olunmayıb.
`ERR_SCAN_WRONG_BATCH`	Bu barkod başqa paketdəki məhsula aiddir.
`ERR_STOP_ALREADY_RESOLVED`	Dayanacaq artıq çatdırılıb və ya uğursuz olub.
`ERR_BATCH_INCOMPLETE`	Paketdə hələ həll olunmamış dayanacaqlar var.
`ERR_COD_VARIANCE_NOTE_REQUIRED`	Yığılan nağd gözlənilən məbləğdən fərqlənir; qeyd tələb olunur.
`ERR_BATCH_INVALID_TRANSITION`	Paket vəziyyət maşını bu keçidi rədd edir.
`ERR_ROUTE_UNAVAILABLE`	Marşrut provayderi işləmədi və ehtiyat üsul marşrut qura bilmədi.
`ERR_DELIVERY_RETRY_LIMIT`	Bu sifariş artıq maksimum sayda təkrar cəhd edilib.
`ERR_ITEM_NOT_EXPECTED`	Skan edilən sətir mərkəzdə gözlənilmir: sifariş ləğv edilib və ya satıcı sətri rədd edib.
`ERR_INTAKE_INCOMPLETE`	Qəbulu tamamlamaq olmaz — sifarişin qəbul edilmiş bəzi sətirləri hələ mərkəzdə skan edilməyib.
`ERR_PARCEL_NOT_IN_BATCH`	Bu bağlama kodu yüklənən reysin heç bir sifarişinə aid deyil.
`ERR_WRONG_STOP_PARCEL`	Qapıda skan edilən bağlama marşrutun başqa dayanacağına aiddir; heç vaxt çatdırılma kimi qeydə alınmır.
`ERR_PARCEL_NOT_LOADED`	Bu bağlamanı furqona yükləyən skan yoxdur, ona görə qapıda təhvil verilə bilməz.
`ERR_OUTSIDE_GEOFENCE`	Mövqe dayanacağın ünvanından çatdırılma geohəddinin icazə verdiyindən uzaqdır və səbəb yazılmayıb.
`ERR_DELIVERY_SCAN_INCOMPLETE`	Çatdırıldı qeyd etməzdən əvvəl dayanacağın hər bağlaması qapıda skan edilməlidir.
`ERR_LOCATION_REQUIRED`	Sürücünün yaxın zamanda onlayn mövqe siqnalı olmadan marşrut başlaya bilməz.

Dəstək, geri qaytarma və qaytarılma

Dəstək, geri qaytarma və qaytarılma
Kod	Mənası
`ERR_TICKET_CLOSED`	Dəstək bileti bağlıdır və yeni mesaj qəbul edə bilməz.
`ERR_TICKET_NOT_ASSIGNABLE`	Bilet həmin əməkdaşa təyin oluna bilməz.
`ERR_CSAT_NOT_ALLOWED`	Məmnunluq qiyməti yalnız həll olunmuş və ya bağlanmış biletə verilə bilər.
`ERR_CSAT_ALREADY_GIVEN`	Bu biletə artıq məmnunluq qiyməti verilib.
`ERR_REFUND_AMOUNT_EXCEEDS`	Geri qaytarma sifariş üzrə ödənilmiş və ya artıq qaytarılmış məbləği aşardı.
`ERR_REFUND_INVALID_STATE`	Geri qaytarma bu əməliyyata icazə verən statusda deyil.
`ERR_REFUND_ORDER_NOT_ELIGIBLE`	Sifariş cari statusunda geri qaytarıla bilməz.
`ERR_RETURN_NOT_ELIGIBLE`	Sifariş cari statusunda geri qaytarıla bilməz.

Platforma administrasiyası

Platforma administrasiyası
Kod	Mənası
`ERR_DEPENDENCY_UNAVAILABLE`	Arxa plandakı xidmət (Redis) əlçatmaz idi — sorğu tətbiq edilmədi. Geri çəkilmə ilə təkrarlamaq təhlükəsizdir.
`ERR_ZONE_INVALID_POLYGON`	Çatdırılma zonası poliqonu düzgün qapalı halqa deyil.
`ERR_SETTLEMENT_EXISTS`	Bu satıcı və dövr üçün hesablaşma artıq mövcuddur.
`ERR_SETTLEMENT_INVALID_STATE`	Hesablaşma bu əməliyyata icazə verən statusda deyil.
`ERR_SETTLEMENT_PERIOD_OPEN`	Hesablaşma dövrü hələ bitməyib.
`ERR_SETTING_UNKNOWN`	Bu açarla platforma parametri yoxdur.
`ERR_SETTING_INVALID`	Parametr dəyəri icazə verilən aralıq və ya tipdən kənardır.
`ERR_COUPON_INVALID`	Kupon kodu tətbiq olunmur — naməlum, vaxtı keçib, hələ başlamayıb, istifadə limiti dolub və ya minimum sifariş məbləğinə çatmır.
`ERR_COUPON_CODE_TAKEN`	Bu kodla kupon artıq mövcuddur; kodlar unikal olmalıdır.
`ERR_LOYALTY_INSUFFICIENT`	Sifariş hesabdakı Turan xalından çoxunu xərcləməyə çalışır.