Tham chiếu API

Tham chiếu

Tham chiếu mã lỗi

Khi yêu cầu thất bại, xem trạng thái HTTP rồi dùng error.code hoặc error.numeric_code gồm năm chữ số để xác định nguyên nhân. error.message để đọc, không dùng cho logic chương trình. Giữ request_id để chẩn đoán.

400 Bad Request

  • invalid_request10000

    Kiểm tra JSON và các trường bắt buộc.

  • invalid_provider30000

    Kiểm tra mã kênh trong URL.

  • unsupported_action30005

    Thao tác tài khoản không được nhận diện; dùng thao tác trong tài liệu.

  • invalid_conversation_type37000

    type phải là user, group hoặc channel.

  • unsupported_conversation_type37001

    Kênh không hỗ trợ thao tác; chọn thao tác trong bảng hỗ trợ.

  • unsupported_message_type36000

    Dùng message.type được kênh hỗ trợ.

  • unsupported_provider_auth_mode20018

    Dùng auth_mode được kênh hỗ trợ.

  • auth_mode_phone_required20019

    Cách ủy quyền này yêu cầu provider_data.phone khi tạo tài khoản.

  • invalid_reply_token36006

    Không đọc được mã trích dẫn. Sao chép nguyên data.message.reply_token từ sự kiện đến.

  • provider_invalid_request30001

    Kiểm tra các trường và định dạng riêng của kênh.

  • create_api_key_failed11101

    Thao tác bị từ chối. Kiểm tra yêu cầu và giữ request_id.

  • update_api_key_failed11102

    Thao tác bị từ chối. Kiểm tra yêu cầu và giữ request_id.

  • rotate_api_key_failed11103

    Thao tác bị từ chối. Kiểm tra yêu cầu và giữ request_id.

  • update_workspace_failed41001

    Thao tác bị từ chối. Kiểm tra yêu cầu và giữ request_id.

401 Unauthorized

  • missing_api_key11000

    Thêm tiêu đề X-Api-Key.

  • invalid_api_key11001

    Kiểm tra API Key có đúng và được bật hay không.

403 Forbidden

  • cors_forbidden11009

    Nguồn, phương thức hoặc tiêu đề CORS không được phép. Kiểm tra môi trường gọi.

404 Not Found

  • not_found10001

    Kiểm tra đường dẫn API và phương thức HTTP.

  • conversation_not_found37002

    Kênh không tìm thấy cuộc hội thoại; kiểm tra mã định danh và tài khoản.

  • contact_not_found35000

    Không tìm thấy liên hệ trong tài khoản này; kiểm tra mã định danh.

  • group_not_found34004

    Không tìm thấy nhóm trong tài khoản này; kiểm tra ID nhóm.

409 Conflict

  • account_allocation_busy20011

    Đang bận cấp tài khoản; thử lại sau một lúc.

  • no_allocatable_server20013

    Vùng chưa có tài nguyên trống; truy vấn vùng có thể cấp phát.

  • workspace_account_quota_exceeded20014

    Đã đạt giới hạn tài khoản nhắn tin; kiểm tra mức sử dụng và hạn mức.

  • duplicate_provider_account20015

    Danh tính kênh này đã gắn với tài khoản khác trong không gian làm việc.

  • account_already_authorized20016

    Tài khoản đã được ủy quyền. Dùng lại hoặc hủy ủy quyền hiện tại trước khi bắt đầu lại.

  • account_binding_not_found30006

    Tài khoản chưa gắn với kết nối kênh hoạt động; kiểm tra trạng thái.

  • provider_account_mismatch20017

    Danh tính kênh trong yêu cầu không khớp với liên kết tài khoản.

  • provider_not_ready30009

    Kết nối chưa sẵn sàng. Kiểm tra ủy quyền và runtime_status trước khi thử lại.

422 Unprocessable Entity

  • contact_not_found35000

    GET /contacts/info trả về Conversation not found. Kiểm tra mã đích và tài khoản dùng để truy vấn.

500 Internal Server Error

  • create_account_failed20002

    Tạo tài khoản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • update_account_failed20003

    Cập nhật tài khoản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • delete_account_failed20004

    Xoá tài khoản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_account_failed20001

    Lấy tài khoản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_accounts_failed20000

    Liệt kê tài khoản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_session_failed20005

    Trạng thái xác thực: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_auth_state_failed20006

    Trạng thái xác thực: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • run_action_failed20007

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • run_runtime_action_failed20008

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • run_session_action_failed20009

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • run_auth_action_failed20010

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • send_message_failed36001

    Gửi tin nhắn văn bản: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • pin_message_failed36002

    Ghim / bỏ ghim tin nhắn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • revoke_message_failed36003

    Thu hồi tin nhắn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • react_message_failed36004

    Thả cảm xúc vào tin nhắn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • edit_message_failed36005

    Sửa tin nhắn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_conversations_failed37003

    Liệt kê hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_conversation_failed37004

    Chi tiết hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_conversation_members_failed37005

    Liệt kê thành viên: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • mark_conversation_read_failed37006

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • mark_conversation_unread_failed37007

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • mute_conversation_failed37008

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • unmute_conversation_failed37009

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • pin_conversation_failed37010

    Ghim hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • unpin_conversation_failed37011

    Bỏ ghim hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_conversation_labels_failed37012

    Liệt kê nhãn hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • upsert_label_failed37013

    Tạo hoặc cập nhật nhãn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • delete_label_failed37014

    Xoá nhãn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • set_label_members_failed37015

    Thêm / gỡ nhãn trên hội thoại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_contacts_failed35001

    Liệt kê liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_contact_failed35002

    Lấy liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • create_contact_failed35003

    Thêm liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_contact_membership_failed35004

    Kiểm tra trạng thái liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • block_contact_failed35005

    Chặn liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • unblock_contact_failed35006

    Bỏ chặn liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_blocklist_failed35007

    Lấy danh sách chặn: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • set_contact_note_failed35008

    Đặt ghi chú liên hệ: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_groups_failed34000

    Liệt kê nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_group_failed34001

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • create_group_failed34002

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • leave_group_failed34003

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • update_group_members_failed34005

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • update_group_info_failed34006

    Cập nhật thông tin nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_group_join_requests_failed34007

    Danh sách yêu cầu vào nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • update_group_join_requests_failed34008

    Duyệt / từ chối yêu cầu vào nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • set_group_join_approval_mode_failed34009

    Đặt chế độ duyệt vào nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_group_invite_code_failed34010

    Lấy liên kết mời nhóm: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_webhook_endpoints_failed40000

    Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • create_webhook_endpoint_failed40001

    Tạo điểm cuối Webhook: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_webhook_endpoint_failed40002

    Lấy điểm cuối Webhook: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • update_webhook_endpoint_failed40003

    Cập nhật điểm cuối Webhook: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • deactivate_webhook_endpoint_failed40004

    Vô hiệu hoá điểm cuối Webhook: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • delete_webhook_endpoint_failed40005

    Xoá điểm cuối Webhook: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • get_workspace_failed41000

    Lấy workspace hiện tại: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_api_keys_failed11100

    Liệt kê API key: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

  • list_provider_regions_failed30011

    Liệt kê khu vực của nhà cung cấp: Dịch vụ hoặc kênh chưa hoàn tất thao tác. Giữ request_id và kiểm tra kết quả trước khi thử ghi lại.

501 Not Implemented

  • unsupported_by_provider30003

    Kênh không hỗ trợ thao tác; chọn thao tác trong bảng hỗ trợ.

502 Bad Gateway

  • provider_adapter_not_found30004

    Dịch vụ kênh chưa khả dụng. Kiểm tra trạng thái hoặc thử sau; xác nhận kết quả trước khi thử ghi lại.

  • provider_unavailable30002

    Dịch vụ kênh chưa khả dụng. Kiểm tra trạng thái hoặc thử sau; xác nhận kết quả trước khi thử ghi lại.

503 Service Unavailable

  • allocation_service_unavailable20012

    Dịch vụ cấp tài khoản tạm không khả dụng; thử lại sau.

Mã số chi tiết của Provider

Các mã này làm rõ nguyên nhân Provider mà không thay đổi HTTP status hoặc legacy code ban đầu.

  • provider_operation_failed30010

    Provider operation failed

    Kênh chưa hoàn tất thao tác. Giữ request_id để chẩn đoán.

  • group_not_found34004

    Group not found

    Không tìm thấy nhóm. Một số đường dẫn kênh hiện có giữ nguyên trạng thái HTTP và error.code.

  • group_not_participant34011

    Account is not participating in this group

    Nhóm có thể tồn tại nhưng tài khoản này không tham gia.