API cho developer
Gọi mọi công cụ và mọi nguồn dữ liệu từ hệ thống của bạn bằng API key, trừ đúng số credit như trên web.
API không có giá riêng: mỗi lượt gọi trừ đúng số credit của công cụ được gọi, giống như bạn bấm chạy trên web. Credit bị trừ trước khi hệ thống đi lấy dữ liệu, và nếu không lấy được gì dùng được thì một dòng hoàn ngược được ghi vào sổ.
Hai điều nên đọc trước khi viết dòng code đầu tiên. Thứ nhất, công cụ chậm trả về trạng thái đã nhận kèm mã lượt chạy thay vì trả kết quả ngay, nên vòng lặp của bạn phải xử lý cả hai trường hợp. Thứ hai, luôn gửi Idempotency-Key ngay từ lần gọi đầu — nếu mạng lỗi giữa request và response, gửi lại cùng khoá đó trả về kết quả cũ và không trừ credit lần hai.
Bạn đưa vào gì
- Một API key tạo trong ứng dụng.
- Mã công cụ và các tham số của nó, giống như trên web.
- Một Idempotency-Key tự sinh, để gọi lại an toàn.
Bạn nhận lại gì
- Kết quả dạng JSON, cùng dữ liệu như bản web.
- Với công cụ chạy nền: mã lượt chạy để đọc kết quả sau.
- Số credit đã trừ của lượt đó.
Giới hạn một lượt
- Không có giá riêng: mỗi lượt gọi trừ giá của công cụ được gọi. Đừng viết cứng con số đó vào code của bạn, vì quản trị sửa được.
- Giới hạn một lượt của từng công cụ giống hệt bản web. Không có gói không giới hạn.
- Có giới hạn số lần gọi mỗi phút. Hãy rải lịch chạy thay vì gọi dồn.
Công cụ này không làm gì
- Không có endpoint nào trả về email, số điện thoại cá nhân, hay danh sách người để liên hệ.
- Không có đường tắt: không cách nào chạy một công cụ mà không đi qua đúng bộ chạy của nó.
- Tài khoản đã gửi yêu cầu chặn dữ liệu bị từ chối trước khi trừ credit, qua API như qua web.
Câu hỏi thường gặp
Mọi con số ở đây là ước tính, tính từ những gì nền tảng hiển thị công khai. Không phải số liệu nội bộ của kênh hay của sàn, và không phải số đã kiểm toán.