ClickUni
Вхід Реєстрація
HTTP API для автоматизації

Пишіть клієнтам першими з будь-якої системи

API ClickUni приймає GET або POST запити, ставить повідомлення в чергу, повертає ідентифікатор і дозволяє перевіряти стан відправки.

Дивитися запити Отримати токен
api.php 
POST /api.php
token={token}
phone=380661234567
message=Ваше замовлення прийнято
Основний запит

Відправка повідомлень

Усі повідомлення через API потрібно надсилати лише через HTTPS. Підтримуються запити типу GET та POST.

https://click-uni.com/api.php?token={token}&phone={phone}&message={message}
https://click-uni.com/api.php?token=5e75b6cc9528bbcbc2843da816968d1c&phone=0509395315&message=Привіт
tokenString, обов'язковий. Токен, який автоматично видається після реєстрації.
phoneString, обов'язковий. Номер телефону у форматі 380661234567 або 0661234567. Нецифрові символи ігноруються, для 10 цифр з 0 додається код країни 38.
messageString, обов'язковий. Текст повідомлення у форматі URL. Підтримуються %0A для переносу, %20 для пробілу і mes_separation для розділення на частини.
file_urlString, необов'язковий. URL файлу, зображення або документа, який буде прикріплено до повідомлення.
cURL 
curl -X POST "https://click-uni.com/api.php" \
  -d "token=5e75b6cc9528bbcbc2843da816968d1c" \
  -d "phone=380661234567" \
  -d "message=Привіт%20світе!%0AЯк%20справи?" \
  -d "file_url=https://example.com/file.jpg"
JavaScript fetch 
fetch("https://click-uni.com/api.php", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    token: "5e75b6cc9528bbcbc2843da816968d1c",
    phone: "380661234567",
    message: "Привіт світе! Як справи?",
    file_url: "https://example.com/file.jpg"
  })
})
Відповідь для повідомлення, розділеного через mes_separation 
<response>
  <status>success</status>
  <description>Усі частини повідомлення підготовлено до відправки</description>
  <messages>
    <item>
      <message_id>6e6bc4e49dd477ebc98ef4046c067b5f</message_id>
      <message>Частина 1</message>
    </item>
    <item>
      <message_id>b6d767d2f8ed5d21a44b0e5886680cb9</message_id>
      <message>Частина 2</message>
    </item>
  </messages>
</response>
XML для одного повідомлення 
<response>
  <status>success</status>
  <description>Повідомлення підготовлено до відправки</description>
  <message_id>6e6bc4e49dd477ebc98ef4046c067b5f</message_id>
  <message>Привіт світе!</message>
</response>
Помилка 
{
  "status": "error",
  "error": "Параметри token, phone або message відсутні або порожні"
}
Контроль доступу

Перевірка тарифу

Запит дозволяє перевірити активний тариф, залишок повідомлень і баланс користувача. Підтримуються запити типу GET та POST.

https://click-uni.com/api.php?type=tariff&token={token}
https://click-uni.com/api.php?type=tariff&token=5e75b6cc9528bbcbc2843da816968d1c
typeString, обов'язковий. Значення tariff для перевірки тарифу користувача.
tokenString, обов'язковий. Токен користувача, який видається після реєстрації.
cURL 
curl -X POST "https://click-uni.com/api.php" \
  -d "type=tariff" \
  -d "token=5e75b6cc9528bbcbc2843da816968d1c"
JavaScript fetch 
fetch("https://click-uni.com/api.php", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    type: "tariff",
    token: "5e75b6cc9528bbcbc2843da816968d1c"
  })
})
Приклад відповіді 
<response>
  <status>success</status>
  <description>Тариф користувача знайдено</description>
  <tariff>
    <name>Premium</name>
    <tariff_id>2</tariff_id>
    <date_start>2025-01-01</date_start>
    <date_end>31.12.2025</date_end>
    <days_left>83</days_left>
    <value_msg>1000</value_msg>
    <balance>500.00</balance>
  </tariff>
</response>
Помилка 
<response>
  <status>error</status>
  <description>Користувача не знайдено по токену</description>
</response>
Статус доставки

Перевірка стану повідомлення

Після відправки API повертає message_id. За ним можна перевірити поточний стан повідомлення. Підтримуються запити типу GET та POST.

https://click-uni.com/api.php?type=check&token={token}&message_id={message_id}
https://click-uni.com/api.php?type=check&token=5e75b6cc9528bbcbc2843da816968d1c&message_id=6e6bc4e49dd477ebc98ef4046c067b5f
typeString, обов'язковий. Значення check для перевірки статусу повідомлення.
tokenString, обов'язковий. Токен користувача, який видається після реєстрації.
message_idString, обов'язковий. Ідентифікатор повідомлення, який повертається при відправці.
cURL 
curl -X POST "https://click-uni.com/api.php" \
  -d "type=check" \
  -d "token=5e75b6cc9528bbcbc2843da816968d1c" \
  -d "message_id=6e6bc4e49dd477ebc98ef4046c067b5f"
JavaScript fetch 
fetch("https://click-uni.com/api.php", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    type: "check",
    token: "5e75b6cc9528bbcbc2843da816968d1c",
    message_id: "6e6bc4e49dd477ebc98ef4046c067b5f"
  })
})
Приклад відповіді 
<response>
  <status>success</status>
  <description>Повідомлення знайдено</description>
  <message_id>6e6bc4e49dd477ebc98ef4046c067b5f</message_id>
  <status_id>2</status_id>
  <status_name>Доставлено</status_name>
  <phone>******1234</phone>
</response>
Помилка 
<response>
  <status>error</status>
  <description>Параметр message_id відсутній</description>
</response>