API Tham chiếu

---

Danh sách kho hàng

Method	GET
URL	/order/list-shop

Response

{
  "error": false,
  "ref": null,
  "message": "Thành công",
  "data": [
    {
      "shop_id": 1,
      "shop_name": "BELL VN",
      "phone": null,
      "address": "11460-11462 Pagemill Rd, Dallas, TX 75243",
      "street": "11460-11462 Pagemill Rd",
      "city": "Dallas",
      "state_code": "TX",
      "zip_code": "75243",
      "national_id": 132
    }
  ]
}

Giải thích

No.	Field Name	Data Type	Description
1	error	boolean	Trạng thái lỗi (false = thành công)
2	ref	String	Mã tham chiếu yêu cầu (có thể null)
3	message	String	Thông báo kết quả xử lý
4	data	Array	Danh sách thông tin shop / kho hàng
5	data[].shop_id	Long	ID shop / kho hàng
6	data[].shop_name	String	Tên shop / kho hàng
7	data[].phone	String	Số điện thoại liên hệ (có thể null)
8	data[].address	String	Địa chỉ đầy đủ
9	data[].street	String	Tên đường và số nhà
10	data[].city	String	Thành phố
11	data[].state_code	String	Mã bang / tỉnh (ví dụ: TX)
12	data[].zip_code	String	Mã bưu chính
13	data[].national_id	Long	Mã quốc gia (tham chiếu danh mục quốc gia)

---

Danh sách bang / tỉnh

Method	GET
URL	/categories/list-state

Response

{
  "error": false,
  "ref": null,
  "message": "Thành công",
  "data": [
    {
      "state_name": "Alabama",
      "state_code": "AL"
    },
    {
      "state_name": "Arizona",
      "state_code": "AZ"
    }
  ]
}

Giải thích

No.	Field Name	Data Type	Description
1	error	boolean	Trạng thái lỗi (false = thành công)
2	ref	String	Mã tham chiếu yêu cầu (có thể null)
3	message	String	Thông báo kết quả xử lý
4	data	Array	Danh sách bang / tỉnh
5	data[].state_name	String	Tên đầy đủ của bang / tỉnh
6	data[].state_code	String	Mã bang / tỉnh (ISO 3166-2)

---

Danh sách quốc gia

Method	GET
URL	/categories/list-national

Response

{
  "error": false,
  "ref": null,
  "message": "Thành công",
  "data": {
    "totalCount": 267,
    "data": [
      {
        "national_id": 1,
        "national_code": "DB",
        "national_name": "Đài Bắc",
        "phone_code": null
      },
      {
        "national_id": 2,
        "national_code": "Z9",
        "national_name": "Rest Of World",
        "phone_code": null
      },
      {
        "national_id": 3,
        "national_code": "IR",
        "national_name": "Iran (Islamic Rep.)",
        "phone_code": "98"
      },
      {
        "national_id": 4,
        "national_code": "IQ",
        "national_name": "Iraq",
        "phone_code": "964"
      },
      {
        "national_id": 5,
        "national_code": "IE",
        "national_name": "Ireland",
        "phone_code": "353"
      }
    ]
  }
}

Giải thích

No.	Field Name	Data Type	Description
1	error	boolean	Trạng thái lỗi (false = thành công)
2	ref	String	Mã tham chiếu yêu cầu (có thể null)
3	message	String	Thông báo kết quả xử lý
4	data	Object	Đối tượng chứa dữ liệu phân trang
5	data.totalCount	Integer	Tổng số bản ghi
6	data.data	Array	Danh sách quốc gia
7	data.data[].national_id	Long	ID quốc gia
8	data.data[].national_code	String	Mã quốc gia (ISO-2 hoặc mã nội bộ)
9	data.data[].national_name	String	Tên quốc gia
10	data.data[].phone_code	String	Mã điện thoại quốc gia (có thể null)