API Hop

เอกสาร

เอกสาร 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 โดยตรง

ความสามารถที่รองรับ

  1. หากมีเพียง username ให้เรียกดึงผู้ใช้ตามชื่อก่อนแล้วอ่าน data.id
  2. ใช้ data.id เพื่อเรียกดึงไทม์ไลน์ผู้ใช้
  3. หากต้องการโปรไฟล์ผู้เขียนในการตอบกลับไทม์ไลน์ ให้ส่ง expansions=author_id

กฎปรับเป็นมาตรฐาน

  • เอนด์พอยต์ผู้ใช้ส่งออบเจ็กต์ผู้ใช้หนึ่งรายการ: { "data": { ... } }
  • เอนด์พอยต์ไทม์ไลน์ส่งอาร์เรย์ทวีต: { "data": [ ... ], "meta": { ... } }
  • เมื่อขอ expansions=author_id การตอบกลับไทม์ไลน์จะรวม includes.users
  • user.fields และ tweet.fields ควบคุมการเลือกฟิลด์เสริม
  • ออบเจ็กต์ผู้ใช้คง id, name และ username เสมอ
  • ออบเจ็กต์ทวีตคง id และ text เสมอ

ฟิลด์เสริม

user.fields

ฟิลด์ผู้ใช้มาตรฐานที่รองรับ:

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

ฟิลด์ทวีตมาตรฐานที่รองรับ:

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

การแก้ข้อผิดพลาด

  • ทุกการตอบกลับมี X-Request-Id
  • บันทึกไว้เมื่อการเรียกล้มเหลว ผลผิดปกติ หรือบริการแจ้งเกินขีดจำกัดอัตรา
  • สำหรับคำถามค่าบริการ ให้เก็บ X-Request-Id และเวลาคำขอ

เอนด์พอยต์