TikTok · มาแรง
เบต้า
ข้อมูลสาธารณะจากแพลตฟอร์มโซเชียล คิดเงินต่อการเรียก ใช้คีย์ API และยอดเงินเดียวกับการเรียกโมเดล
เฉพาะบัญชีที่เติมเงินครั้งแรกแล้ว ไม่มีทดลองใช้ฟรี · จะคิดเงินเฉพาะเมื่อการเรียกส่งกลับ HTTP 200 และ data ไม่ว่างเท่านั้น ผลลัพธ์ว่าง พารามิเตอร์ถูกปฏิเสธ หรือต้นทางล้มเหลวจะไม่คิดเงิน
พารามิเตอร์คำขอ
ใส่พารามิเตอร์ใน query string ด้วยชื่อของแพลตฟอร์มเอง ตัวอย่างมาจากแคตตาล็อก ให้แทนที่ตัวระบุด้วยเนื้อหาที่คุณต้องการดึง
| ชื่อ | ประเภท | จำเป็น | ตัวอย่าง | คำอธิบาย |
|---|---|---|---|---|
count | integer | ไม่ | 15 | Number per page |
region | string | ไม่ | "US" | Region code, optional, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US. |
ตัวอย่างคำขอ
curl --get "https://api.chinaapi.ai/v1/social/tiktok/trending" \
-H "Authorization: Bearer $CHINAAPI_KEY"โครงสร้างการตอบกลับ
การตอบกลับที่สำเร็จจะห่อข้อมูลของแพลตฟอร์มไว้ในซองข้อมูลขนาดเล็ก ทุกอย่างภายใน data — ชื่อฟิลด์ เคอร์เซอร์แบ่งหน้า และ ID — เป็นของแพลตฟอร์มเอง ให้ส่งเคอร์เซอร์กลับไปตามที่ได้รับมาทุกประการ
{
"object": "social.result",
"platform": "tiktok",
"capability": "trending",
"data": { … }
}การแบ่งหน้า
เอนด์พอยต์นี้ไม่มีพารามิเตอร์แบ่งหน้า
ข้อผิดพลาดและกรณีที่ไม่คิดเงิน
| รหัสสถานะ | รหัสข้อผิดพลาด | ความหมาย |
|---|---|---|
| 400 | — | พารามิเตอร์ไม่รู้จัก ซ้ำ ยาวเกินไป ผิดชนิด หรือขาดหายไป รวมถึงกรณีที่ไม่ได้ระบุสมาชิกใดเลยของกลุ่ม "อย่างน้อยหนึ่งรายการจาก" ฟิลด์ code ของข้อผิดพลาดจะบอกว่าเป็นกรณีใด เช่น unknown_parameter หรือ missing_parameter |
| 403 | model_requires_topup | บัญชียังไม่ได้เติมเงินครั้งแรก |
| 404 | social_data_no_result | ไม่มีคู่แพลตฟอร์มและความสามารถนี้ หรือแพลตฟอร์มไม่พบข้อมูลใดสำหรับพารามิเตอร์เหล่านี้ (social_data_no_result) |
| 429 | social_data_capacity_reached | ความจุรายวันของเบต้าถูกใช้หมดแล้วและจะรีเซ็ตเวลา 00:00 UTC หรือแพลตฟอร์มกำลังยุ่ง ซึ่งลองใหม่อีกไม่กี่วินาทีก็จะผ่าน อย่าลองซ้ำถี่ ๆ ในลูป |
| 502 | social_data_no_result | แหล่งข้อมูลไม่ตอบกลับ หรือตอบกลับโดยไม่มีข้อมูล |
| 503 | social_data_unavailable | เอนด์พอยต์นี้ถูกหยุดชั่วคราวอยู่ในขณะนี้ แคตตาล็อกสดจะแสดงสถานะเป็น paused |
การตอบกลับเหล่านี้ไม่มีรายการใดถูกคิดเงิน
ทุกการตอบกลับมีเฮดเดอร์ X-Oneapi-Request-Id แนบค่านี้มาเมื่อติดต่อฝ่ายสนับสนุน เราจะค้นหาการเรียกครั้งนั้นได้
เงื่อนไขของเบต้า
เติมเงินครั้งแรกให้เสร็จก่อนเรียกใช้ เครดิตทดลองใช้กับเอนด์พอยต์เหล่านี้ไม่ได้ บัญชีที่ไม่เคยเติมเงินจะได้รับ HTTP 403 model_requires_topup เวอร์ชันเบต้าไม่มี SLA และแพลตฟอร์ม เอนด์พอยต์ และราคาอาจเปลี่ยนแปลงได้
ปฏิบัติตามข้อกำหนดของแต่ละแพลตฟอร์มและกฎการคุ้มครองข้อมูลที่ใช้กับคุณ ห้ามใช้ API นี้สร้างโปรไฟล์ของบุคคล การเข้าสู่ระบบ การดึงข้อมูลติดต่อ การปั่นยอดการมีส่วนร่วม และการเข้าถึงเนื้อหาส่วนตัวหรือเนื้อหาแบบเสียเงิน อยู่นอกขอบเขตของเบต้านี้