Hướng dẫn tích hợp API

Bắt đầu chỉ với 5 bước đơn giản

Xác thực

Mọi điểm cuối API đều yêu cầu xác thực bằng khóa API của bạn. Bạn có thể truyền khóa theo bất kỳ cách nào sau đây:

Gửi một tin nhắn WhatsApp đến một số điện thoại hoặc nhóm. Tin nhắn được xếp hàng và gửi đi khi ứng dụng máy tính đang chạy.

POST https://onemessengerhub.com/api/whatsapp-session/send

Tham số

Yêu cầu mẫu

curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"mobile": "1234567890", "message": "Hello!"}'

Yêu cầu GET đơn giản (Trình duyệt hoặc Liên kết)

https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!

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

{

  "success": true,

  "message": "Message queued successfully",

  "data": {

    "message_id": 123,

    "recipient": "1234567890",

    "status": "pending"

  }

}

Lưu hoặc đổi tên một liên hệ trong WhatsApp của bạn. Thao tác được xếp hàng và xử lý bởi ứng dụng máy tính.

POST https://onemessengerhub.com/api/whatsapp-session/save-contact

Tham số

Yêu cầu mẫu

curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"contact_id": "1234567890", "name": "John Doe"}'

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

{

  "success": true,

  "message": "Contact save operation queued",

  "data": {

    "operation_id": 456,

    "contact_id": "[email protected]",

    "status": "pending"

  }

}

Xóa một liên hệ khỏi WhatsApp của bạn. Thao tác được xếp hàng và xử lý bởi ứng dụng máy tính.

POST https://onemessengerhub.com/api/whatsapp-session/remove-contact

Tham số

Yêu cầu mẫu

curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"contact_id": "1234567890"}'

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

{

  "success": true,

  "message": "Contact remove operation queued",

  "data": {

    "operation_id": 789,

    "contact_id": "[email protected]",

    "status": "pending"

  }

}

Xử lý lỗi

API sử dụng các mã trạng thái HTTP tiêu chuẩn. Đây là những phản hồi lỗi phổ biến:

Lỗi xác thực (401)

{

  "success": false,

  "message": "Invalid or inactive API key"

}

Lỗi xác minh (422)

{

  "success": false,

  "message": "Validation failed",

  "errors": {

    "mobile": ["The mobile field is required when group id is not present."],

    "message": ["The message field is required."]

  }

}

Những gì bạn có thể xây dựng

Nhiều API hơn sắp ra mắt

Chúng tôi đang mở rộng các API của mình để bao quát nhiều nền tảng và trường hợp sử dụng hơn.