RESTful API თქვენი მაღაზიისთვის — შეკვეთის შექმნა, ტრეკინგი და Webhook ერთი გასაღებით.
# შეკვეთის შექმნა curl -X POST https://sonicexpress.ge/api/v1/orders \ -H "Authorization: Bearer sk_live_..." \ -d '{ "delivery_name": "გიორგი მ.", "delivery_phone": "555123456", "delivery_address": "ვაჟა-ფშაველა N12", "weight": 2.5 }'
Response
{ "success": true, "tracking_code": "SNAB12CD34", "price": 7 }სამი endpoint ყველა სცენარისთვის — სია, შექმნა, ტრეკინგი.
შეკვეთების სია
/api/v1/ordersბოლო 200 შეკვეთა. ფილტრი სტატუსით, გვერდება limit/page პარამეტრებით.
შეკვეთის შექმნა
/api/v1/ordersახალი შეკვეთა პირდაპირ სისტემაში. ფასი ავტომატურად გამოითვლება ტარიფის მიხედვით.
შეკვეთის ტრეკინგი
/api/v1/orders/:trackingერთი შეკვეთის სრული ინფორმაცია ტრეკინგ-კოდით. სტატუსი რეალური დროის განახლებით.
ყოველ მოთხოვნაში გადაიტანეთ API გასაღები Authorization header-ში. გასაღები B2B კაბინეტში გენერირდება.
Authorization: Bearer sk_live_YOUR_KEY
API მხოლოდ B2B/კომპანიის ანგარიშებს ემსახურება.
B2B კაბინეტში Webhook URL-ის დაყენებით, სისტემა ავტომატურად გამოგიგზავნით შეტყობინებას შეკვეთის სტატუსის ცვლილებისას.
{
"event": "order.created",
"timestamp": "2026-01-15T10:30:00.000Z",
"data": {
"tracking_code": "SNAB12CD34",
"reference_id": "SHOP-001",
"status": "მიღებულია",
"price": 7
}
}შეკვეთის შექმნა — სულ ოთხი ველი სავალდებულოა.
curl -X POST https://sonicexpress.ge/api/v1/orders \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"delivery_name": "გიორგი მამაძე",
"delivery_phone": "555123456",
"delivery_address": "ვაჟა-ფშაველა N12",
"weight": 2.5
}'{
"success": true,
"tracking_code": "SNAB12CD34",
"price": 7,
"status": "მიღებულია",
"tracking_url": "https://sonicexpress.ge/track/SNAB12CD34"
}