1688 · ค้นหาสินค้า

เบต้า

ข้อมูลสาธารณะจากแพลตฟอร์มโซเชียล คิดเงินต่อการเรียก ใช้คีย์ API และยอดเงินเดียวกับการเรียกโมเดล

บัญชีที่ยังไม่ชำระเงินเรียกใช้ได้สูงสุดวันละ 50 ครั้ง บัญชีที่ชำระเงินแล้วไม่จำกัดจำนวนครั้งต่อวัน รีเซ็ตเวลา 00:00 UTC · จะคิดเงินเฉพาะเมื่อการเรียกส่งกลับ HTTP 200 และ data ไม่ว่างเท่านั้น ผลลัพธ์ว่าง พารามิเตอร์ถูกปฏิเสธ หรือต้นทางล้มเหลวจะไม่คิดเงิน

พารามิเตอร์คำขอ

ใส่พารามิเตอร์ใน query string ด้วยชื่อของแพลตฟอร์มเอง ตัวอย่างมาจากแคตตาล็อก ให้แทนที่ตัวระบุด้วยเนื้อหาที่คุณต้องการดึง

ชื่อ	ประเภท	จำเป็น	ตัวอย่าง	คำอธิบาย
`keyword`	string	ใช่	`"coffee cup"`	Search keyword. Results are normalized product records, not the raw platform response.
`limit`	integer	ไม่	`5`	Maximum records returned per call: 5. Price covers this single bounded batch; larger requests are rejected before dispatch. ค่าเริ่มต้น `5`

ตัวอย่างคำขอ

curl --get "https://api.chinaapi.ai/v1/social/alibaba1688/product-search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=coffee cup'

โครงสร้างการตอบกลับ

คำตอบที่สำเร็จส่งข้อมูลของเอนด์พอยต์นั้นใน data ซึ่งอาจเป็นข้อมูลเดิมของแพลตฟอร์มหรือออบเจ็กต์/อาร์เรย์รูปแบบมาตรฐาน ตรวจสอบข้อกำหนดและ data_type ในแค็ตตาล็อกหากมี ส่งโทเค็นแบ่งหน้ากลับไปยังเอนด์พอยต์เดิมโดยไม่แก้ไข

{
  "object": "social.result",
  "platform": "alibaba1688",
  "capability": "product-search",
  "data": { … }
}

การแบ่งหน้า

เอนด์พอยต์นี้ไม่มีพารามิเตอร์แบ่งหน้า

ข้อผิดพลาดและกรณีที่ไม่คิดเงิน

รหัสสถานะ	รหัสข้อผิดพลาด	ความหมาย
400	—	พารามิเตอร์ไม่รู้จัก ซ้ำ ยาวเกินไป ผิดชนิด หรือขาดหายไป รวมถึงกรณีที่ไม่ได้ระบุสมาชิกใดเลยของกลุ่ม "อย่างน้อยหนึ่งรายการจาก" ฟิลด์ `code` ของข้อผิดพลาดจะบอกว่าเป็นกรณีใด เช่น `unknown_parameter` หรือ `missing_parameter`
403	—	คีย์ API ไม่มีสิทธิ์สำหรับคำขอนี้
404	`social_data_no_result`	ไม่มีคู่แพลตฟอร์มและความสามารถนี้ หรือแพลตฟอร์มไม่พบข้อมูลใดสำหรับพารามิเตอร์เหล่านี้ (`social_data_no_result`)
429	`data_api_daily_limit_exceededsocial_data_capacity_reached`	ความจุรายวันของเบต้าถูกใช้หมดแล้วและจะรีเซ็ตเวลา 00:00 UTC หรือแพลตฟอร์มกำลังยุ่ง ซึ่งลองใหม่อีกไม่กี่วินาทีก็จะผ่าน อย่าลองซ้ำถี่ ๆ ในลูป บัญชีที่ยังไม่ชำระเงินเรียกใช้ได้สูงสุดวันละ 50 ครั้ง บัญชีที่ชำระเงินแล้วไม่จำกัดจำนวนครั้งต่อวัน รีเซ็ตเวลา 00:00 UTC
502	`social_data_no_result`	แหล่งข้อมูลไม่ตอบกลับ หรือตอบกลับโดยไม่มีข้อมูล
503	`social_data_unavailable`	เอนด์พอยต์นี้ถูกหยุดชั่วคราวอยู่ในขณะนี้ แคตตาล็อกสดจะแสดงสถานะเป็น `paused`

การตอบกลับเหล่านี้ไม่มีรายการใดถูกคิดเงิน

ทุกการตอบกลับมีเฮดเดอร์ X-Oneapi-Request-Id แนบค่านี้มาเมื่อติดต่อฝ่ายสนับสนุน เราจะค้นหาการเรียกครั้งนั้นได้

เงื่อนไขของเบต้า

บัญชีที่ยังไม่ชำระเงินเรียกใช้ได้สูงสุดวันละ 50 ครั้ง บัญชีที่ชำระเงินแล้วไม่จำกัดจำนวนครั้งต่อวัน รีเซ็ตเวลา 00:00 UTC เวอร์ชันเบต้าไม่มี SLA และแพลตฟอร์ม เอนด์พอยต์ และราคาอาจเปลี่ยนแปลงได้

ปฏิบัติตามข้อกำหนดของแต่ละแพลตฟอร์มและกฎการคุ้มครองข้อมูลที่ใช้กับคุณ ห้ามใช้ API นี้สร้างโปรไฟล์ของบุคคล การเข้าสู่ระบบ การดึงข้อมูลติดต่อ การปั่นยอดการมีส่วนร่วม และการเข้าถึงเนื้อหาส่วนตัวหรือเนื้อหาแบบเสียเงิน อยู่นอกขอบเขตของเบต้านี้

สิทธิประโยชน์อัตรา API ข้อมูล

บัญชีแบบชำระเงินเริ่มต้นที่ 10 คำขอ/วินาที และเพิ่มอัตโนมัติตามยอดใช้จ่ายสุทธิสะสม สูงสุด 100 คำขอ/วินาที

บัญชีที่ยังไม่ชำระเงินเรียกใช้ได้สูงสุดวันละ 50 ครั้ง บัญชีที่ชำระเงินแล้วไม่จำกัดจำนวนครั้งต่อวัน รีเซ็ตเวลา 00:00 UTC

ยอดใช้จ่ายสุทธิสะสม	คำขอต่อวินาที
ค่าเริ่มต้นแบบชำระเงิน	10/s
มากกว่า 50 ดอลลาร์สหรัฐ	20/s
มากกว่า 500 ดอลลาร์สหรัฐ	50/s
มากกว่า 1500 ดอลลาร์สหรัฐ	100/s

คำนวณจากค่าบริการ API ข้อมูลที่ชำระบัญชีแล้วหักเงินคืนจากการเรียกใช้ ไม่รวมยอดเติมเงินและค่าใช้จ่าย API โมเดล

คีย์ API ทั้งหมดในบัญชีใช้อัตรานี้ร่วมกัน โดยวัดคำขอต่อวินาที ไม่ใช่จำนวนคำขอที่ทำงานพร้อมกัน

เอนด์พอยต์ของผู้ให้บริการมีขีดจำกัดความจุแยกต่างหาก ซึ่งส่งผลต่ออัตราประมวลผลที่ใช้งานได้จริง

ต้องการอัตราที่สูงขึ้นหรือไม่ ติดต่อเราทางอีเมล [email protected]