Tài liệu API cho nhà phát triển

Tài liệu API cho nhà phát triển

Hướng dẫn triển khai API cho web của bạn.

1. Lấy toàn bộ đơn hàng đã mua

Endpoint: GET 127.0.0.1:8000/api/d/orders

Trạng thái đơn hàng:

  • Running: Đang chạy
  • Processing: Đang xử lý
  • Completed: Hoàn thành
  • Cancelled: Đã huỷ
  • Refunded: Đã hoàn tiền
  • Failed: Thất bại
  • Pending: Chờ xử lý
  • Partially Refunded: Hoàn tiền một phần
  • Partially Completed: Hoàn thành một phần
  • WaitingForRefund: Chờ hoàn tiền

Headers:

  • X-Access-Token: [Token]
  • Content-Type: application/json

Ví dụ Request:

curl --location '127.0.0.1:8000/api/d/orders' \
--header 'X-Access-Token: [Token]' \
--header 'Content-Type: application/json'

Ví dụ Response:

{
  "code": "200",
  "status": "success",
  "data": [...]
}

2. Đơn hàng theo ID

Endpoint: GET 127.0.0.1:8000/api/d/orders/{id}

Headers:

  • X-Access-Token: [Token]
  • Content-Type: application/json

Ví dụ Request:

curl --location '127.0.0.1:8000/api/d/orders/4' \
--header 'X-Access-Token: [Token]' \
--header 'Content-Type: application/json'

Ví dụ Response:

{
  "code": "200",
  "status": "success",
  "data": {...}
}

3. Tạo một đơn hàng mới

Endpoint: POST 127.0.0.1:8000/api/v1/start/create/order

Headers:

  • X-Access-Token: [Token]
  • Content-Type: application/json

Body:

{
    "provider_package": "test_api",
    "provider_server": "sv-1",
    "object_id": "1234325345",
    "quantity": 100,
    "note": "Test API"
}

Ví dụ Request:

curl --location '127.0.0.1:8000/api/v1/start/create/order' \
--header 'X-Access-Token: [Token]' \
--header 'Content-Type: application/json' \
--form 'provider_package="test_api"' \
--form 'provider_server="sv-1"' \
--form 'object_id="1234325345"' \
--form 'quantity="100"' \
--form 'note="Test API"'

Ví dụ Response:

{
  "code": "200",
  "status": "success",
  "message": "Đơn hàng của bạn đã được tạo thành công !",
  "data": {
    "id": 7,
    "order_code": "CD_17141036632133",
    "price": "5",
    "payment": 500,
    "status": "Processing"
  }
}