API Twitter

Dịch vụ cung cấp REST API Twitter thống nhất. Bên gọi nhận cấu trúc phản hồi nhất quán kiểu X API v2.

/v1/twitter

Xác thực

Mọi điểm cuối API Twitter cần xác thực Bearer Token.

Authorization: Bearer YOUR_API_KEY

Đường dẫn cơ sở

Gọi các đường dẫn tương đối này dưới URL cơ sở API của bạn.

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

Cấu trúc phản hồi

Phản hồi API Twitter thành công không bọc trong success/data; chúng trả trực tiếp các trường chuẩn hóa data, includes và meta.

Năng lực được hỗ trợ

Quy trình khuyến nghị

1. Nếu chỉ có username, gọi Lấy người dùng theo tên trước và đọc data.id.
2. Dùng data.id để gọi Lấy dòng thời gian người dùng.
3. Nếu cần dữ liệu hồ sơ tác giả trong phản hồi dòng thời gian, truyền expansions=author_id.

Quy tắc chuẩn hóa

• Điểm cuối người dùng trả một đối tượng người dùng: { "data": { ... } }
• Điểm cuối dòng thời gian trả mảng bài đăng: { "data": [ ... ], "meta": { ... } }
• Khi yêu cầu expansions=author_id, phản hồi dòng thời gian có includes.users
• user.fields và tweet.fields điều khiển lựa chọn trường tùy chọn
• Đối tượng người dùng luôn giữ id, name và username
• Đối tượng bài đăng luôn giữ id và text

Trường tùy chọn

user.fields

Trường người dùng chuẩn hóa được hỗ trợ:

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

tweet.fields

Trường bài đăng chuẩn hóa được hỗ trợ:

• 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

Gỡ lỗi

• Mọi phản hồi có X-Request-Id
• Ghi lại khi lời gọi thất bại, kết quả bất thường hoặc dịch vụ trả giới hạn tốc độ
• Với câu hỏi tính phí, giữ X-Request-Id và thời gian yêu cầu

Điểm cuối