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

​
Вступ

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

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Середовище Python 3.7 і вище
  • Встановлена бібліотека requests: pip install requests

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

Головна кінцева точка для виклику Short URL API: 
POST https://api.acedata.cloud/shorturl
Повний приклад коду на Python: 
import requests

url = "https://api.acedata.cloud/shorturl"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "content": "https://platform.acedata.cloud"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Будь ласка, замініть YOUR_API_TOKEN на ваш фактичний токен, отриманий на платформі Ace Data Cloud.

​
Обробка відповіді

Після успішного виклику API повертає дані у форматі JSON. Рекомендується перевіряти HTTP статус-код: 
if response.status_code == 200:
    result = response.json()
    print("Виклик успішний:", result)
else:
    print(f"Виклик не вдався, статус-код: {response.status_code}")
    print(response.text)

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

Для API, що підтримують асинхронні завдання, можна отримувати результати через callback URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Результат буде надіслано на ваш сервер через callback URL

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

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

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