Перейти к содержанию
На этой странице

Первый REST-запрос

Начните с чтения. Такой запрос проверяет авторизацию и не меняет данные пространства.

cURL

bash
curl --request GET \
  --url https://api.viralmaxing.com/api/analytics/accounts/ \
  --header "X-API-Key: $VIRALMAXING_API_KEY" \
  --header "Accept: application/json"

JavaScript на сервере

js
const response = await fetch('https://api.viralmaxing.com/api/analytics/accounts/', {
  headers: {
    Accept: 'application/json',
    'X-API-Key': process.env.VIRALMAXING_API_KEY,
  },
});

if (!response.ok) {
  throw new Error(`Viralmaxing API returned ${response.status}`);
}

const accounts = await response.json();

Как читать ответ

  • 200 означает, что запрос выполнен;
  • 400 указывает на неверные параметры или бизнес-ограничение;
  • 401 просит заменить или добавить ключ;
  • 403 указывает на недостаточную роль;
  • 429 требует паузы перед повтором.

Не повторяйте запрос без изменений после 400. Прочитайте тело ошибки и исправьте параметры. Для 429 используйте задержку с увеличением интервала.

Все доступные пути и структуры ответов находятся в API Reference.

Читать дальше