Перейти до основного вмісту

​
Вступ

Short URL — це сервіс скорочення посилань, наданий Ace Data Cloud. Через уніфікований API Ace Data Cloud ви можете швидко викликати Short URL за допомогою cURL для скорочення URL, налаштування власного домену та інших функцій.

​
Передумови

  • Мати обліковий запис Ace Data Cloud та отримати API Token
  • Встановлене середовище терміналу з cURL

​
Базове використання

Основна кінцева точка API Short URL: 
POST https://api.acedata.cloud/shorturl
Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/shorturl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "https://platform.acedata.cloud"}'
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Приклад відповіді

Після успішного виклику повертається дані у форматі JSON, наприклад: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Обробка відповіді за допомогою jq

Рекомендується використовувати інструмент jq для форматованого виводу: 
curl -s -X POST https://api.acedata.cloud/shorturl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "https://platform.acedata.cloud"}' | jq .

​
Обробка помилок

Поширені коди помилок:
Код стануОпис
401Помилка автентифікації, перевірте API Token
403Недостатньо коштів або відсутній доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

​
Наступні кроки