Налаштування власного X API Key

​

Крок 1: Створіть ваш X Developer Account

1

Увійдіть до Developer Console

Перейдіть на console.x.com і увійдіть за допомогою вашого облікового запису X. Див. посібник із початку роботи X, якщо вам потрібна допомога.

2

Завершіть онбординг

Завершіть онбординг для розробників і прийміть Угоду розробника та політики.

3

Отримайте доступ до консолі

Тепер ви в X Developer Console.

​

Крок 2: Створіть застосунок

1

Перейдіть до Apps

У Developer Console перейдіть до Apps.

2

Створіть застосунок

На панелі App натисніть Create App (див. документацію з налаштування App X для отримання деталей). Введіть назву застосунку (зазвичай ім’я вашого бренду). Ця назва буде відображатися на екрані авторизації OAuth, коли користувачі підключають свій обліковий запис X.

3

Виберіть середовище

Виберіть середовище Production у випадаючому меню.

4

Закрийте початкове спливаюче вікно з обліковими даними

X згенерує кілька облікових даних. Проігноруйте ці облікові дані та закрийте це вікно.

​

Крок 3: Налаштуйте дозволи застосунку

1

Відкрийте налаштування вашого застосунку

Під “Apps” знайдіть новий застосунок (оновіть сторінку, якщо він не з’являється), потім натисніть на нього, щоб переглянути його деталі.Під User authentication settings натисніть Set up.

2

Встановіть дозволи застосунку

Під App permissions виберіть Read and write and Direct message. Це потрібно для повної підтримки функцій, включаючи публікацію та DM.

3

Встановіть тип застосунку

Під Type of App виберіть Web App, Automated App or Bot. Це правильний вибір для серверних інтеграцій, як-от Ayrshare.

4

Встановіть URL зворотного виклику та вебсайту

Під App info:

• Callback URL: Додайте обидва наступні URL зворотного виклику:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

Не пропускайте цей крок. Ці URL зворотного виклику необхідні для потоку зв’язування OAuth. Коли ваші кінцеві користувачі авторизують підключення X, X перенаправляє їх назад на одну з цих URL для завершення процесу зв’язування. Якщо їх немає, потік OAuth не вдасться з помилкою 403 Callback URL not approved.

5

Збережіть налаштування

Натисніть Save. Ви можете проігнорувати спливаюче вікно OAuth 2.0, оскільки ви використовуватимете лише 2 з ключів OAuth 1.0 (API Key та API Secret).

Важливо: встановіть дозволи перед зв’язуванням. Дозволи, які ви обираєте тут, визначають, що може робити ваш застосунок. Якщо ви змінюєте дозволи після зв’язування вашого облікового запису X через OAuth, вам потрібно буде повторно зв’язати, щоб новий Access Token успадкував оновлені дозволи.

1. API Key (він же Consumer Key, ідентифікатор X-застосунку)
2. API Secret (він же Consumer Secret)

​

Крок 4: Купіть кредити X API

1

Перейдіть до біллінгу

У Developer Console натисніть Billing → Credits у лівій бічній панелі.

2

Купіть кредити

Купіть кредити (мінімум $5, чого достатньо для сотень викликів API). Кожен виклик API — це частка цента, тому вартість має бути мінімальною для більшості користувачів.

3

Увімкніть автоматичне поповнення

Ви можете увімкнути автоматичне поповнення, щоб уникнути перебоїв у роботі, та керувати обмеженням витрат, встановивши максимальну суму, яку ви можете витратити у своєму платіжному циклі.

​

Крок 5: Оновіть ваші виклики Ayrshare API

1. API Key (він же Consumer Key, ідентифікатор X-застосунку)
2. API Secret (він же Consumer Secret)

​

Довідник заголовків

​

Приклади коду

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"]},
)

​

Міграція існуючих профілів (Business та Enterprise)

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

​

Перевірте ваше налаштування

​

Як працює ціноутворення X API

​

Переваги використання власного X API Key

• Брендований OAuth-досвід: Користувачі бачать назву та брендинг вашого застосунку під час авторизації доступу до X.
• Виділені ліміти запитів: Ваше використання API регулюється лімітами вашого власного X Developer account, окремо від інших користувачів Ayrshare. Ви можете моніторити своє використання в X Developer Console та ознайомитися з документацією про ліміти запитів X API.
• Контроль над обліковими даними: Ваші API Key та Secret залишаються у вашому власному X Developer account. Ayrshare не зберігає ваші секретні ключі.
• Портативність: Оскільки користувачі автентифікуються за допомогою вашого X App, ваша інтеграція залишається повністю під вашим контролем.
• Видимість використання: Ваша панель X Developer показує запити API, ліміти запитів та використання кредитів.

​

Безпека

• Ваш API Key та API Secret не зберігаються Ayrshare.
• Для загальних найкращих практик безпеки див. посібник із безпеки автентифікації X.

​

FAQ

​

Усунення несправностей

​

Потрібна допомога?