Cho đội kỹ thuật

Đặt đơn và theo dõi từ hệ thống của bạn

Chính các điểm cuối trang yourpost đang dùng để lấy danh mục, tạo đơn và ghi thanh toán. Quyền dùng được mở theo từng tài khoản đã xác minh.

Tình trạng

Mở theo yêu cầu. Đăng ký quan tâm kèm cách bạn định dùng; đội ngũ trả lời các bước cấp quyền.

Dành cho ai

Agency nhiều khách

Đặt đơn cho từng khách từ công cụ của mình.

Đội có bảng điều hành riêng

Kéo trạng thái đơn về bảng đang dùng.

Đơn lặp lại

Hệ thống của bạn tự gửi lại đơn quen thuộc, không gõ lại.

Điểm cuối

GET/api/servicesCông khai

Danh sách dịch vụ đang mở cho tài khoản của bạn.

GET/api/ordersCần đăng nhập

Đơn của bạn kèm trạng thái và số dư ví.

POST/api/ordersCần đăng nhập

Tạo đơn. Gửi kèm tiêu đề Idempotency-Key để gửi lại không tạo đơn trùng.

POST/api/topupsCần đăng nhập

Ghi mã chuyển khoản; số dư chỉ đổi sau khi được xác minh.

Ví dụ: tạo đơn

curl -X POST https://yourpost.ai/api/orders \
  -H "Authorization: Bearer <session token>" \
  -H "Idempotency-Key: <new uuid per order>" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"<id from /api/services>","quantity":<quantity>}'

Quy tắc

  • Lỗi trả về dạng JSON một trường: {"error": "…"} kèm mã HTTP tương ứng.
  • Tạo đơn giới hạn 5 lần mỗi giờ cho mỗi địa chỉ; chờ rồi gửi lại với cùng Idempotency-Key.
  • Nội dung vẫn qua bước duyệt trước khi đăng, như đơn đặt trên trang.

Bước tiếp theo

Muốn dùng API?

Cho biết bạn muốn nối gì và khoảng bao nhiêu đơn mỗi tháng.