🚚 CDEK: qoşulma və API açarları
CDEK ilə müqavilə, şəxsi kabinetdə API açarı (Account və Secure password), anbar-anbar/anbar-qapı tarifləri, EDU test konturu, CDEK Qazaxıstan və Belarus.
Harada qurulur: İdarəetmə paneli → «Göndərişlər» → «Çatdırılma xidmətləri» düyməsi (və ya filialın kartı → WEB → «Çatdırılma xidmətləri»).
Nə lazım olacaq#
- CDEK ilə hüquqi şəxs və ya fərdi sahibkar üçün müqavilə;
- lk.cdek.ru şəxsi kabinetinə giriş;
- bağlamaları təhvil verdiyiniz ünvan (anbar, mağaza və ya ofis).
Xidmətin kabinetində açarları necə almaq olar#
- CDEK ilə müqavilə bağlayın: cdek.ru saytında müraciət («Biznesə» → «Müqavilə bağla») və ya şəhərinizdəki menecer vasitəsilə. Müqavilə olmadan API açarları verilmir.
- Müqavilənin rəsmiləşdirildiyi hesabla lk.cdek.ru şəxsi kabinetinə daxil olun.
- «İnteqrasiya» bölməsini açın və API üçün açar yaradın (açar artıq varsa — ondan istifadə edin).
- İki dəyəri kopyalayın: Account (müştəri identifikatoru) və Secure password (gizli parol). Secure password-u parol kimi saxlayın: messencerlərdə göndərməyin.
Xidmətin kartına nə yazmaq lazımdır#
| Sahə | Nə yazmaq lazımdır |
|---|---|
| Göndərənin ünvanı | CDEK-in bağlamaları götürdüyü və ya sizin gətirdiyiniz anbarın və ya mağazanın ünvanı |
| Hansı tariflər göstərilsin | «anbar-anbar» (alma məntəqəsinə təhvil verirsiniz, alıcı alma məntəqəsindən götürür), «anbar-qapı» (kuryer alıcıya qədər), «qapı-qapı» (kuryer sizdən götürür) |
| account (client_id) | kabinetdəki Account dəyəri |
| secure_password (client_secret) | kabinetdəki Secure password dəyəri |
Yoxlama#
- «Yadda saxla» düyməsini basın.
- «Qoşulmanı yoxla» düyməsini basın: kartın altında tariflər görünəcək. «Mock rejimi» yazısı açarların qoşulmadığını və tariflərin nümunə olduğunu bildirir.
- Kartda «Aktiv et …» seçimini işarələyin — bundan sonra xidmət alıcının sifariş rəsmiləşdirməsində görünəcək.
Açarlar olmadan və test rejimi#
Açarlar olmadan kart CDEK-in tədris konturunda işləyir, o əlçatan deyilsə — nümunə tarifləri göstərir: beləliklə, hələ müqavilədən əvvəl çatdırılmanın vitrində necə göründüyünə baxmaq olar. «Test rejimi (sandbox)» işarəsi sorğuları api.edu.cdek.ru tədris konturuna göndərir — bunun üçün ayrı test açarları lazımdır, onları CDEK verir (sənədləşdirmədə dərc olunmuş demo açarları o rədd edir).
Tez-tez rast gəlinən problemlər#
- «Qoşulma xətası» / invalid_client — açarlar yerləri dəyişdirilib, boşluqla kopyalanıb və ya döyüş açarları ilə «Test rejimi» aktivdir. Test rejimini söndürün və Account ilə Secure password-u yenidən daxil edin.
- Cavabda tariflər yoxdur — seçilmiş tarif bu istiqamət üzrə işləmir — əlavə «anbar-qapı» seçimini işarələyin və ya göndərənin ünvanını yoxlayın.
- Mağaza Qazaxıstanda və ya Belarusdadır — CDEK Qazaxıstan (cdek.kz) və CDEK Belarus (cdek.by) ayrı şirkətlərdir: Rusiya kabinetinin açarları orada işləmir, yerli CDEK ilə müqavilə və kabinet lazımdır. Açarların alınması qaydası eynidir.
Keçidlər#
- Xidmətin saytı: https://www.cdek.ru/
- Kabinet: https://lk.cdek.ru/
- API sənədləşdirməsi: https://apidoc.cdek.ru/