خواندن دوبارهی یک سفارش
پاتریس یار با GET /patris-yar/orders/:id یک سفارش را دوباره میخواند. این کار برای سفارشهایی است که قلمی بدون کد کالای پاتریس داشتند و بعداً کد آن در سایت ثبت شده است.
این endpoint کی صدا زده میشود؟
در هر دور همگامسازی، پاتریس یار حداکثر ۲۰ سفارشِ دارای قلم بیکد را دوباره میخواند. اقلام بر اساس جایگاه با هم تطبیق داده میشوند. اگر تعداد اقلام تغییر کرده باشد، آن سفارش رد میشود.
پیشنیازها
Endpoint
GET /patris-yar/orders/1532
هدرها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
X-Payava-Key | string | بله | کلید API حساب پاتریس. |
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
id | integer (path) | بله | همان id سفارش که در GET /patris-yar/orders فرستاده شد. |
نمونه درخواست و پیادهسازی
- curl
- C#
- Python
- PHP
- Node.js
- Go
خواندن یک سفارش
curl https://shop.example.com/patris-yar/orders/1532 \
-H "X-Payava-Key: YOUR_API_KEY"
GET /orders/:id
patris.MapGet("/orders/{id:long}", async (long id, IShopStore store) =>
{
var order = await store.GetOrderAsync(id); // any status, delivered or not
return order is null
? Results.Json(new { code = "payava_patris_not_found", message = "Order not found" }, statusCode: 404)
: Results.Json(PatrisOrderMapper.ToPatris(order));
});
GET /orders/:id
@router.get("/orders/{order_id}")
def order(order_id: int):
o = store.get_order(order_id) # any status, delivered or not
if o is None:
return JSONResponse({"code": "payava_patris_not_found", "message": "Order not found"}, status_code=404)
return to_patris_order(o)
GET /orders/:id
if ($method === 'GET' && preg_match('#^/orders/(\d+)$#', $route, $m)) {
$order = $store->order((int) $m[1]); // any status, delivered or not
if ($order === null) {
respond(404, ['code' => 'payava_patris_not_found', 'message' => 'Order not found']);
}
respond(200, to_patris_order($order));
}
GET /orders/:id
router.get('/orders/:id', async (req, res, next) => {
try {
const id = /^\d+$/.test(req.params.id) ? Number(req.params.id) : 0;
const order = id > 0 ? await store.getOrder(id) : null; // any status, delivered or not
if (!order) {
return res.status(404).json({ code: 'payava_patris_not_found', message: 'Order not found' });
}
res.json(toPatrisOrder(order));
} catch (err) {
next(err);
}
});
GET /orders/:id
func order(w http.ResponseWriter, r *http.Request) {
id, err := strconv.ParseInt(r.PathValue("id"), 10, 64)
if err != nil {
writeJSON(w, http.StatusNotFound, map[string]string{"code": "payava_patris_not_found", "message": "Order not found"})
return
}
o, found, err := store.Order(r.Context(), id) // any status, delivered or not
if err != nil || !found {
writeJSON(w, http.StatusNotFound, map[string]string{"code": "payava_patris_not_found", "message": "Order not found"})
return
}
writeJSON(w, http.StatusOK, toPatrisOrder(o))
}
// patris.HandleFunc("GET "+base+"/orders/{id}", order)
نمونه پاسخ موفق
پاسخ خود سفارش است، نه آرایه:
200 OK
{
"id": 1532,
"number": "1532",
"status": "processing",
"created": "2026-11-07T10:42:13+03:30",
"customer_name": "علی رضایی",
"phone": "09120000000",
"subtotal": 2400000,
"discount": 200000,
"shipping": 300000,
"total": 2500000,
"lines": [
{ "pip": "101009001", "sku": "", "name": "لنت ترمز جلو", "quantity": 2, "unit_price": 1200000, "discount": 200000 }
]
}
فیلدهای کامل در قالب سفارش آمدهاند.
کدهای خطا
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
401 | payava_patris_unauthorized | — | کلید نادرست است. |
404 | payava_patris_not_found | — | سفارش پیدا نشد. پاتریس یار آن را نادیده میگیرد و خطا نشان نمیدهد. |
نکتهها
- این endpoint باید سفارش را با هر وضعیتی برگرداند، حتی اگر قبلاً تحویل شده باشد.
- شکل پاسخ باید دقیقاً همان شکل هر سفارش در
GET /patris-yar/ordersباشد.