Idempotency
POST /api/v1/merchant/orders дараах толгойг шаардана:
http
Idempotency-Key: <your-stable-key>Түлхүүр энэ API key болон энэ үйлдэлд хамаарна. Хамгийн урт нь 200 тэмдэгт.
Хоосон эсвэл байхгүй бол 400 MERCHANT_API_IDEMPOTENCY_KEY_REQUIRED.
Нэг логик хүсэлтийг дахин илгээхдээ мөн түлхүүрийг ашигла. Оролдлого бүрт шинэ түлхүүр бүү үүсгэ.
| Юу илгээх вэ | Юу буцах вэ |
|---|---|
| Амжилтын дараа мөн түлхүүр, мөн body | Анхны амжилттай хариу |
| Мөн түлхүүр, өөр body | 409 MERCHANT_API_IDEMPOTENCY_CONFLICT |
| Мөн түлхүүр, нөгөө хүсэлт дуусаагүй | Хүлээгээд мөн түлхүүр, мөн body-гоор дахин илгээ. Эхнийх нь дууссан бол түүний хариу ирнэ. Дуусаагүй бол 409 MERCHANT_API_IDEMPOTENCY_IN_PROGRESS |
| Амжилтгүй хүсэлтийн дараа мөн түлхүүр | Амжилтгүй оролдлого хадгалагдахгүй. Мөн түлхүүр, мөн body-гоор дахин илгээ |
externalOrderId нь тусдаа. Энэ нь таны захиалгын id бөгөөд энэ API key дээр давтагдахгүй. Дахин илгээхэд хоёр дахь Chuchu захиалга үүсэхгүй. Дараагийн body өмнө хадгалсан худалдааны өгөгдөлтэй таарахгүй бол 409 EXTERNAL_ORDER_CONFLICT.
Захиалгын дугаараа Idempotency-Key болгож болно. Тэр нь зөвхөн давтан хүсэлтийг ялгана. externalOrderId-г орлохгүй.