เอกสาร API Hop
API Twitter
>-
บริการนี้ให้ API Twitter REST แบบรวมศูนย์ ผู้เรียกได้รับโครงสร้างการตอบกลับแบบ X API v2 ที่สม่ำเสมอ
text
/v1/twitterการยืนยันตัวตน
เอนด์พอยต์ API Twitter ทั้งหมดต้องยืนยันตัวตนด้วย Bearer Token
http
Authorization: Bearer YOUR_API_KEYเส้นทางหลัก
เรียกเส้นทางสัมพัทธ์เหล่านี้ใต้ URL หลัก API ของคุณ
text
GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweetsรูปแบบการตอบกลับ
การตอบกลับ API Twitter ที่สำเร็จไม่ครอบด้วย success/data แต่ส่งฟิลด์มาตรฐาน data, includes และ meta โดยตรง
ความสามารถที่รองรับ
ข้อมูลผู้ใช้ค้นหาผู้ใช้ Twitter ด้วย username หรือค้นทรัพยากรผู้ใช้โดยตรงด้วย idไทม์ไลน์ผู้ใช้ค้นหาไทม์ไลน์ด้วย id รวมทวีตมาตรฐาน ข้อมูลผู้เขียนเพิ่มเติม และเมทาดาทาแบ่งหน้า
ขั้นตอนที่แนะนำ
- หากมีเพียง
usernameให้เรียกดึงผู้ใช้ตามชื่อก่อนแล้วอ่านdata.id - ใช้
data.idเพื่อเรียกดึงไทม์ไลน์ผู้ใช้ - หากต้องการโปรไฟล์ผู้เขียนในการตอบกลับไทม์ไลน์ ให้ส่ง
expansions=author_id
กฎปรับเป็นมาตรฐาน
- เอนด์พอยต์ผู้ใช้ส่งออบเจ็กต์ผู้ใช้หนึ่งรายการ:
{ "data": { ... } } - เอนด์พอยต์ไทม์ไลน์ส่งอาร์เรย์ทวีต:
{ "data": [ ... ], "meta": { ... } } - เมื่อขอ
expansions=author_idการตอบกลับไทม์ไลน์จะรวมincludes.users user.fieldsและtweet.fieldsควบคุมการเลือกฟิลด์เสริม- ออบเจ็กต์ผู้ใช้คง
id,nameและusernameเสมอ - ออบเจ็กต์ทวีตคง
idและtextเสมอ
ฟิลด์เสริม
user.fields
ฟิลด์ผู้ใช้มาตรฐานที่รองรับ:
created_atdescriptionentitieslocationpinned_tweet_idprofile_banner_urlprofile_image_urlprotectedpublic_metricsurlverifiedverified_type
tweet.fields
ฟิลด์ทวีตมาตรฐานที่รองรับ:
attachmentsauthor_idconversation_idcreated_atedit_history_tweet_idsentitiesin_reply_to_user_idlangpossibly_sensitivepublic_metricsreferenced_tweetssource
การแก้ข้อผิดพลาด
- ทุกการตอบกลับมี
X-Request-Id - บันทึกไว้เมื่อการเรียกล้มเหลว ผลผิดปกติ หรือบริการแจ้งเกินขีดจำกัดอัตรา
- สำหรับคำถามค่าบริการ ให้เก็บ
X-Request-Idและเวลาคำขอ