API näme öz içine alýar
Dükan satyjy API-si dolandyryş paneliniň we Menejer programmasynyň işleýän şol bir dükanyny açýar: harytlar, kategoriýalar, brendler, ýygyndylar, baş sahypanyň bölümleri, sargytlar, analitika we dükanyň öz maglumatlary.
Bu dükanlaryň hakykatdan soraýan birikmeleri üçin edilen sepdir: üpjün edijiniň nyrh sanawyny ýüklemek, sargytlary hasapçylyk ulgamyna çekmek ýa-da galyndylary eýýäm işleýän ammaryňyz bilen deňleşdirmek.
Esasy salgy
https://dukan.biz/api/merchant/v1
Bu gollanmadaky ähli ýollar şoňa görä görkezilen, ähli jogaplar bolsa JSON görnüşinde gelýär.
API açaryny alyň
Sazlamalar, soňra Işläp düzüjilere bölümini açyň we açar dörediň. Oňa näme üçindigini aýdýan at beriň, şonda soň ony näme döwjekdigini çak etmän yzyna alyp bolar.
Açar diňe bir gezek — döredilen pursaty — görkezilýär. Şonda göçürip alyň; ýitse, ony pozup, täzesini dörediň.
Soragy tassyklamak
Açary bearer-token hökmünde iberiň:
Authorization: Bearer YOUR_API_KEY
Accept: application/json
Açar bir dükana degişli we siziň oňa beren rugsatlaryňyzy göterýär. Başga dükana edilen soraglar dymyp boş jogap bermän, ret edilýär.
Sorag ibermek
GET /products?status=published&limit=50
GET /orders?status=new
GET /analytics?from=2026-08-01&to=2026-08-31
Sanawlar sahypalara bölünýär, we her jogap indiki sahypanyň kursoryny göterýär. Sahypalary sanaman, kursor boýunça gidiň: katalog siz ony okap durkaňyz üýtgeýär.
Dükana ýazmak
POST, PATCH we DELETE şol bir meýdany öz içine alýar: harytlary we olaryň wariantlaryny döretmek hem üýtgetmek, sargydy indiki tapgyra geçirmek, kategoriýalary, brendleri we ýygyndylary üýtgetmek hem-de baş sahypanyň bölüm sanawyny çalyşmak.
Pul onluk drob däl-de, iň kiçi birlikde bitewi san bolup iberilýär we gaýdyp gelýär, şonuň üçin siziň birikmäňizden geçende hiç zat togalanmaýar.
Webhook-lar
Salgy hasaba alyň, we Dükan dükanyňyzda bir zat bolanda şoňa iberer: täze sargyt, sargydyň tapgyrynyň üýtgemegi, harydyň gutarmagy.
Her iberme gol çekilen — mazmuny bilen bir zat etmezden öň goly barlaň. Çalt 2xx jogabyny beriň, işi bolsa soň ediň: tassyklanmadyk iberme aralygy artdyryp gaýtalanýar, şonuň üçin işleýjiňiz şol bir wakanyň gaýtalanmagyny şol bir waka hasaplamaly.
Sorag çäkleri
Soraglar açar boýunça çäklendirilen. Her jogap galan çägiňizi başlyklarda göterýär, çäkden geçen sorag bolsa garaşmaly sekuntlaryň sany bilen 429 bolup gaýdýar.
Sanawy bir gezek okap saklaň, hemişe soraman. Çalt bilinmeli zatlar üçin aýlaw däl-de, webhook ulanyň.
Ýalňyşlyklar
Ýalňyşlyklar dogry HTTP ýagdaýy we haýsy meýdanyň günäkärdigini aýdýan JSON mazmuny bilen gelýär:
401— açar ýok, nädogry ýa-da yzyna alnan.403— açar dogry, ýöne muny etmäge haky ýok.404— bu dükanda beýle ýazgy ýok.422— sorag düşnükli, ýöne meýdan nädogry; haýsydygyny mazmun aýdýar.429— aşa köp sorag.
Wersiýalar
Wersiýa ýolda görkezilen. Goşmaçalar — täze meýdan, täze usul — wersiýanyň içinde bolýar, şonuň üçin müşderi programmalaryňyzy nätanyş meýdanlary geçip gidýän edip ýazyň. Bar bolan müşderi programmasyny döwjek zatlar täze wersiýa we geçiş möhletini alýar.
Işläp düzüjiler üçin goldaw
[email protected] salgysyna ýazyp, birikdirjek ulgamyňyzy, näme synanyşandygyňyzy we haýsy sorag hem jogapda saklanandygyňyzy gysgaça beýan ediň.