{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/vi/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Định dạng phản hồi chung","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"định-dạng-phản-hồi-chung","__idx":0},"children":["Định dạng phản hồi chung"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tất cả các phản hồi API MoreLogin đều tuân theo định dạng JSON tiêu chuẩn."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cấu-trúc-phản-hồi","__idx":1},"children":["Cấu trúc phản hồi"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"msg\": null,\n  \"data\": {},\n  \"requestId\": \"unique-request-id\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"trường"},"children":["trường"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Loại"},"children":["Loại"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Mô tả"},"children":["Mô tả"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mã kết quả ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," = thành công, các giá trị khác biểu thị lỗi"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["msg"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chuỗi | vô giá trị"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Thông báo lỗi. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," khi thành công"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["đối tượng | mảng | vô giá trị"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tải trọng phản hồi. Cấu trúc thay đổi theo điểm cuối"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mã đị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ợ"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phản-hồi-thành-công","__idx":2},"children":["Phản hồi thành công"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"msg\": null,\n  \"data\": {\n    \"id\": 1234567890\n  },\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phản-hồi-lỗi","__idx":3},"children":["Phản hồi lỗi"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 99001,\n  \"msg\": \"Invalid parameters\",\n  \"data\": null,\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phản-hồi-được-phân-trang","__idx":4},"children":["Phản hồi được phân trang"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Danh sách các điểm cuối trả về dữ liệu được phân trang theo định dạng sau:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"msg\": null,\n  \"data\": {\n    \"total\": 100,\n    \"current\": 1,\n    \"pages\": 10,\n    \"dataList\": [\n      { ... },\n      { ... }\n    ]\n  },\n  \"requestId\": \"...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"trường"},"children":["trường"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Mô tả"},"children":["Mô tả"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tổng số hồ sơ"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["current"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Số trang hiện tại"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tổng số trang"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dataList"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mảng bản ghi cho trang hiện tại"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mã-trạng-thái-http","__idx":5},"children":["Mã trạng thái HTTP"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Trạng thái"},"children":["Trạng thái"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Mô tả"},"children":["Mô tả"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yêu cầu được xử lý thành công (kiểm tra trường ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," để biết kết quả kinh doanh)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trái phép - mã thông báo truy cập không hợp lệ hoặc hết hạn"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bị cấm - không đủ quyền"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quá nhiều yêu cầu - vượt quá giới hạn tốc độ"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lỗi máy chủ nội bộ - liên hệ với bộ phận hỗ trợ"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mẹo"]},": Luôn kiểm tra trường ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," trong nội dung phản hồi chứ không chỉ mã trạng thái HTTP. Trạng thái HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," có ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]}]}]},"headings":[{"value":"Định dạng phản hồi chung","id":"định-dạng-phản-hồi-chung","depth":1},{"value":"Cấu trúc phản hồi","id":"cấu-trúc-phản-hồi","depth":2},{"value":"Phản hồi thành công","id":"phản-hồi-thành-công","depth":2},{"value":"Phản hồi lỗi","id":"phản-hồi-lỗi","depth":2},{"value":"Phản hồi được phân trang","id":"phản-hồi-được-phân-trang","depth":2},{"value":"Mã trạng thái HTTP","id":"mã-trạng-thái-http","depth":2}],"frontmatter":{"seo":{"title":"Định dạng phản hồi chung"}},"lastModified":"2026-06-10T11:47:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/vi/api-reference/getting-started/response-format","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}