Thiết lập X API Key của riêng bạn

​

Bước 1: Tạo tài khoản X Developer

1

Đăng nhập vào Developer Console

Truy cập console.x.com và đăng nhập bằng tài khoản X của bạn. Xem hướng dẫn bắt đầu của X nếu bạn cần trợ giúp.

2

Hoàn tất onboarding

Hoàn tất onboarding cho developer và chấp nhận Developer Agreement cùng các chính sách.

3

Truy cập console

Bạn hiện đã ở trong X Developer Console.

​

Bước 2: Tạo một App

1

Điều hướng đến Apps

Trong Developer Console, điều hướng đến Apps.

2

Tạo app

Trong App dashboard, nhấp Create App (xem tài liệu thiết lập App của X để biết chi tiết). Nhập tên app (thường là tên thương hiệu của bạn). Tên này sẽ xuất hiện trên màn hình uỷ quyền OAuth khi người dùng kết nối tài khoản X của họ.

3

Chọn môi trường

Chọn môi trường Production trong menu thả xuống.

4

Đóng cửa sổ pop-up credentials ban đầu

X sẽ tạo một số credential. Bỏ qua các credential này và đóng cửa sổ này lại.

​

Bước 3: Cấu hình quyền cho App

1

Mở cài đặt app của bạn

Trong “Apps,” tìm app mới (làm mới trang nếu app không xuất hiện), sau đó nhấp vào nó để xem chi tiết.Trong User authentication settings, nhấp Set up.

2

Thiết lập quyền cho app

Trong App permissions, chọn Read and write and Direct message. Điều này bắt buộc để hỗ trợ đầy đủ tính năng, bao gồm cả đăng bài và DM.

3

Thiết lập loại app

Trong Type of App, chọn Web App, Automated App or Bot. Đây là lựa chọn đúng cho các tích hợp phía server như Ayrshare.

4

Thiết lập callback và website URL

Trong App info:

• Callback URL: Thêm cả hai callback URL sau:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

Đừng bỏ qua bước này. Các callback URL này bắt buộc cho luồng liên kết OAuth. Khi người dùng cuối uỷ quyền kết nối X, X sẽ chuyển hướng họ về một trong các URL này để hoàn tất quy trình liên kết. Nếu thiếu, luồng OAuth sẽ thất bại với lỗi 403 Callback URL not approved.

5

Lưu cài đặt

Nhấp Save. Bạn có thể bỏ qua cửa sổ pop-up OAuth 2.0, vì bạn chỉ sử dụng 2 khoá của OAuth 1.0 (API Key và API Secret).

Quan trọng: Thiết lập quyền trước khi liên kết. Các quyền bạn chọn ở đây quyết định app của bạn có thể làm gì. Nếu bạn thay đổi quyền sau khi đã liên kết tài khoản X qua OAuth, bạn sẽ cần liên kết lại để Access Token mới kế thừa quyền đã cập nhật.

1. API Key (còn gọi là Consumer Key, định danh của X app)
2. API Secret (còn gọi là Consumer Secret)

​

Bước 4: Mua X API Credits

1

Điều hướng đến billing

Trong Developer Console, nhấp Billing → Credits ở thanh bên trái.

2

Mua credits

Mua credits (mức tối thiểu là $5, đủ cho hàng trăm lệnh API). Mỗi lệnh gọi API chỉ tốn một phần nhỏ của một cent, vì vậy chi phí sẽ tối thiểu đối với hầu hết người dùng.

3

Bật tự động nạp lại

Bạn có thể bật auto-recharge để tránh gián đoạn dịch vụ và quản lý giới hạn chi tiêu bằng cách đặt mức tối đa bạn có thể chi trong chu kỳ thanh toán.

​

Bước 5: Cập nhật các lệnh gọi API Ayrshare của bạn

1. API Key (còn gọi là Consumer Key, định danh của X app)
2. API Secret (còn gọi là Consumer Secret)

​

Tham chiếu Header

​

Ví dụ mã

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

​

Chuyển đổi các profile hiện có (Business & Enterprise)

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

​

Kiểm tra thiết lập của bạn

​

Cách định giá X API hoạt động

​

Lợi ích của việc dùng X API Key của riêng bạn

• Trải nghiệm OAuth có thương hiệu: Người dùng thấy tên app và thương hiệu của bạn khi uỷ quyền truy cập X.
• Giới hạn tốc độ riêng: Việc sử dụng API của bạn được điều chỉnh bởi giới hạn của tài khoản X Developer của riêng bạn, tách biệt khỏi các người dùng Ayrshare khác. Bạn có thể theo dõi sử dụng của mình trong X Developer Console và xem tài liệu về giới hạn tốc độ API của X.
• Kiểm soát thông tin xác thực: API Key và Secret của bạn nằm trong tài khoản X Developer của riêng bạn. Ayrshare không lưu trữ khoá bí mật của bạn.
• Tính di động: Vì người dùng xác thực với X App của bạn, tích hợp của bạn vẫn hoàn toàn nằm dưới sự kiểm soát của bạn.
• Khả năng hiển thị sử dụng: Dashboard X Developer của bạn hiển thị các request API, giới hạn tốc độ và mức sử dụng credit.

​

Bảo mật

• API Key và API Secret của bạn không được Ayrshare lưu trữ.
• Đối với các thực hành bảo mật chung, xem hướng dẫn bảo mật xác thực của X.

​

Câu hỏi thường gặp

​

Xử lý sự cố

​

Cần trợ giúp?