Gọi API lấy dữ liệu TikTok: bắt đầu từ đâu

Mọi công cụ trên CIA đều có đường API tương ứng dưới /api/v1, xác thực bằng khoá API của bạn. Điều quan trọng nhất cần biết trước lần gọi đầu: credit bị trừ trước khi hệ thống gọi dữ liệu, và nếu nhà cung cấp lỗi thì một dòng hoàn ngược được ghi lại.

Ba điều về cách tính tiền

Trừ trước, hoàn sau. Credit bị trừ trước khi gọi. Nếu bạn không nhận được gì dùng được, hệ thống ghi một dòng hoàn ngược. Mọi biến động là một dòng trong sổ, có số dư sau đó — không có chỗ nào sửa số dư mà không để lại dấu.

Giá theo module, đọc từ cấu hình. Giá mỗi công cụ nằm trong bảng sản phẩm và quản trị sửa được, nên đừng viết cứng con số vào code của bạn. Xem bảng giá.

Không có đường tắt. Không có cách nào chạy một công cụ mà không đi qua đúng bộ chạy đó, kể cả qua API.

Công cụ chạy ngay và công cụ chạy nền

Đây là điều làm người mới nhầm nhiều nhất.

Công cụ nhanh trả kết quả ngay trong phản hồi. Công cụ chậm — như radar quảng cáo đa nền tảng, review Google Maps hay báo cáo đa nền tảng — chạy nền: bạn nhận HTTP 202 Accepted kèm mã lượt chạy, rồi đọc kết quả sau.

Nghĩa là code của bạn phải xử lý cả hai mã trạng thái. Viết vòng lặp chỉ chấp nhận 200 là lỗi hay gặp nhất ở lần tích hợp đầu.

Ba lỗi hay gặp ở lần gọi đầu

1. Tài khoản chưa sẵn sàng. Khoá API bị từ chối nếu tài khoản chưa xác minh email hoặc chưa đồng ý phiên bản chính sách hiện hành. Lỗi trả về nói rõ điều này.

2. Tham số không đúng tập giá trị cho phép. Nhiều công cụ chỉ nhận một số giá trị cố định cho tham số số lượng. Đọc tài liệu của từng công cụ thay vì đoán.

3. Gọi lại sau lỗi mạng mà không có Idempotency-Key. Đây là lỗi tốn tiền. Xem Idempotency-Key là gì — đọc trước khi viết vòng lặp retry đầu tiên.

Ranh giới mà API cũng phải tuân

API không trả về email, không trả về số điện thoại cá nhân, và không có endpoint nào trả về danh sách người để liên hệ. Số điện thoại chỉ xuất hiện với cơ sở kinh doanh trên các danh bạ như Google Maps, vì đó là đường dây công khai của họ.

Tài khoản đã gửi yêu cầu chặn tại trang yêu cầu về dữ liệu bị từ chối trước khi hệ thống trừ credit — qua web và qua API như nhau. Xem dữ liệu công khai là gì.

Bắt đầu nhỏ

Gọi một công cụ rẻ nhất trước để kiểm xác thực và định dạng phản hồi. Rồi mới viết vòng lặp. Và đặt Idempotency-Key ngay từ lần gọi đầu, đừng thêm sau.

Câu hỏi thường gặp

Có gói không giới hạn không? Không. Mọi thứ tính theo credit, và mỗi công cụ có giới hạn cứng cho một lượt.

Dữ liệu có phải số liệu chính thức của nền tảng không? Không. Đó là ước tính từ dữ liệu công khai mà nền tảng hiển thị cho mọi người.

Có giới hạn số lần gọi mỗi phút không? Có giới hạn ở tầng dịch vụ theo từng người dùng. Thiết kế code của bạn để xử lý phản hồi bị giới hạn thay vì gọi dồn.