Skip to content
Tài liệu tham khảo API
/
/
Định dạng phản hồi chung
Last updated

Tất cả các phản hồi API MoreLogin đều tuân theo định dạng JSON tiêu chuẩn.

Cấu trúc phản hồi

{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
trườngLoạiMô tả
codeintegerMã kết quả 0 = thành công, các giá trị khác biểu thị lỗi
msgchuỗi | vô giá trịThông báo lỗi. null khi thành công
datađối tượng | mảng | vô giá trịTải trọng phản hồi. Cấu trúc thay đổi theo điểm cuối
requestIdstringMã định danh yêu cầu duy nhất. Bao gồm điều này khi liên hệ với bộ phận hỗ trợ

Phản hồi thành công

{
  "code": 0,
  "msg": null,
  "data": {
    "id": 1234567890
  },
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Phản hồi lỗi

{
  "code": 99001,
  "msg": "Invalid parameters",
  "data": null,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Phản hồi được phân trang

Danh sách các điểm cuối trả về dữ liệu được phân trang theo định dạng sau:

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 100,
    "current": 1,
    "pages": 10,
    "dataList": [
      { ... },
      { ... }
    ]
  },
  "requestId": "..."
}
trườngMô tả
totalTổng số hồ sơ
currentSố trang hiện tại
pagesTổng số trang
dataListMảng bản ghi cho trang hiện tại

Mã trạng thái HTTP

Trạng tháiMô tả
200Yêu cầu được xử lý thành công (kiểm tra trường code để biết kết quả kinh doanh)
401Trái phép - mã thông báo truy cập không hợp lệ hoặc hết hạn
403Bị cấm - không đủ quyền
429Quá nhiều yêu cầu - vượt quá giới hạn tốc độ
500Lỗi máy chủ nội bộ - liên hệ với bộ phận hỗ trợ

Mẹo: Luôn kiểm tra trường code trong nội dung phản hồi chứ không chỉ mã trạng thái HTTP. Trạng thái HTTP 200 có code: 99001 có nghĩa là yêu cầu đã được nhận nhưng xác thực không thành công.

Quickstart

Rate Limits