Створення та управління короткими посиланнями. За допомогою функцій цього модуля можна скорочувати довгі URL для використання їх у своїх SMS розсилках.
Створення короткого посилання
https://api.mobizon.ua/service/Link/Create
Видалення коротких посилань
https://api.mobizon.ua/service/Link/Delete
Отримання основних даних короткого посилання
https://api.mobizon.ua/service/Link/Get
Отримання коротких посилань кампанії
https://api.mobizon.ua/service/Link/GetLinks
Отримання статистики кліків за посиланнями
https://api.mobizon.ua/service/Link/GetStats
Отримання списку посилань
https://api.mobizon.ua/service/Link/List
Редагування даних короткого посилання
https://api.mobizon.ua/service/Link/Update
https://api.mobizon.ua/service/Link/Create
Цей метод призначений для створення коротких посилань.
data array – Параметри посилання
| Параметр | Тип | Опис |
|---|---|---|
data[fullLink] | string | Повне посилання. Посилання, яке необхідно скоротити в форматі правильного URL. Наприклад: https://help.mobizon.com/api-docs/sms-api?utm_campaign=docs&utm_source=help&utm_medium=test#server-response-format або www.mobizon.com |
data[status] | integer | Статус короткого посилання: 0 – посилання неактивне; 1 – посилання активне (встановлено за замовчуванням). |
data[expirationDate] | date | Дата закінчення дії посилання. Посилання буде діяти до кінця доби зазначеного дня в часовому поясі користувача. За замовчуванням строк дії посилання не обмежений. Формат: РРРР-ММ-ДД. |
data[comment] | string | Коментар до посилання. Завдяки цьому полю можна легко знайти коротке посилання серед інших. Наприклад: «Знижки на Чорну П’ятницю» або «Нагадування про негативний баланс». Максимальна довжина коментаря – 255 символів. |
array: Дані створеного короткого посилання
| Поле | Тип | Опис |
|---|---|---|
id | integer | Ідентифікатор посилання. |
code | string | Код короткого посилання. |
shortLink | string | Коротке посилання. |
| Код | Опис |
|---|---|
| 0 | Коротке посилання успішно створене. |
| 1 | Якщо які-небудь параметри містять невірні значення. |
curl -X POST \
'https://api.mobizon.ua/service/link/create?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'data%5BfullLink%5D=http%3A%2F%2Fmobizon.ua&data%5Bstatus%5D=1&data%5BexpirationDate%5D=2020-10-05&data%5Bcomment%5D=%D0%9A%D0%BE%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80+%D0%B4%D0%BE+%D0%BF%D0%BE%D1%81%D0%B8%D0%BB%D0%B0%D0%BD%D0%BD%D1%8F'
var data = "data%5BfullLink%5D=http%3A%2F%2Fmobizon.ua&data%5Bstatus%5D=1&data%5BexpirationDate%5D=2020-10-05&data%5Bcomment%5D=%D0%9A%D0%BE%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80+%D0%B4%D0%BE+%D0%BF%D0%BE%D1%81%D0%B8%D0%BB%D0%B0%D0%BD%D0%BD%D1%8F";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/create?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'create',
array(
'data' => array(
//повне посилання
'fullLink' => 'http://mobizon.ua',
//статус посилання
'status' => '1',
//дата закінчення дії посилання
'expirationDate' => '2020-10-05',
//коментар до посилання
'comment' => 'Коментар до посилання'
)
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.ua/service/Link/Delete
Цей метод призначений для видалення коротких посилань.
| Параметр | Тип | Опис |
|---|---|---|
ids | array | Ідентифікатори посилань. |
Масив даних
| Поле | Тип | Опис |
|---|---|---|
processed | array | Ідентифікатори видалених посилань. |
notProcessed | array | Ідентифікатори невидалених посилань. |
curl -X POST \
'https://api.mobizon.ua/service/link/delete?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'ids%5B0%5D=123&ids%5B1%5D=455&ids%5B2%5D=567'
var data = "ids%5B0%5D=123&ids%5B1%5D=455&ids%5B2%5D=567";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/delete?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'delete',
array(
//ідентифікатори посилань
'ids' => array(
'123',
'455',
'567'
)
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.ua/service/Link/Get
Цей метод дозволяє отримати основні дані короткого посилання за одним із трьох його параметрів: id, code, shortLink.
В одному запиті можна отримати дані тільки одного короткого посилання.
Для отримання необхідно передати один із параметрів:
| Параметр | Тип | Опис |
|---|---|---|
id | integer | Ідентифікатор посилання. |
code | string | Код короткого посилання. Комбінація символів унікальна для кожного короткого посилання. Розташований у самому кінці короткого посилання. Приклад: http://mbz.im/mgjf, де mgif – код короткого посилання. |
shortLink | string | Коротке посилання. URL, створений нашим сервісом, при переході за яким ваші відвідувачі будуть перенаправлені на посилання, спочатку задану вами. Приклад: http://mbz.im/mgjf. |
Масив даних
| Поле | Тип | Опис |
|---|---|---|
id | integer | Ідентифікатор посилання. |
status | integer | Статус, встановлений користувачем: 0 – посилання неактивне; 1 – посилання активне. |
moderatorStatus | integer | Статус, встановлений адміністратором: 0 – заблоковано адміністратором; 1 – підтверджено адміністратором. |
clickCnt | integer | Кількість кліків за коротким посиланням. |
createTs | string | Час створення короткого посилання. Формат: РРРР-ММ-ДД ГГ-ХХ-СС. |
expirationDate | string | Дата закінчення дії короткого посилання. Формат: РРРР-ММ-ДД.Якщо дата не задана – значення поля NULL. |
code | string | Код короткого посилання. |
fullLink | string | Повне посилання. |
shortLink | string | Коротке посилання. |
comment | string | Коментар користувача до короткого посилання. Якщо коментар відсутній – значення поля NULL. |
moderatorComment | string | Коментар модератора. Якщо коментар відсутній – значення поля NULL. |
| Код | Опис |
|---|---|
| 0 | Основні дані короткого посилання успішно отримані. |
| 2 | Якщо посилання з вказаним ідентифікатором не знайдено. |
| 12 | Якщо не передано жодного з параметрів. |
curl -X POST \
'https://api.mobizon.ua/service/link/get?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'code=zxc'
var data = "code=zxc";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/get?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'get',
array(
//код короткого посилання
'code' => 'zxc'
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.ua/service/Link/GetLinks
Цей метод дозволяє отримати інформацію та статистику списку коротких посилань кампанії.
| Параметр | Тип | Опис |
|---|---|---|
campaignId | integer | Ідентифікатор кампанії. |
Структура об'єкта посилання: масив коротких посилань, в якому кожен елемент містить наступні поля:
| Поле | Тип | Опис |
|---|---|---|
id | integer | Ідентифікатор короткого посилання. |
code | string | Код короткого посилання. |
fullLink | string | Повне посилання. |
shortLink | string | Коротке посилання. |
clickCnt | integer | Кількість кліків по короткому посиланню. |
redirectCnt | integer | Кількість переходів по короткому посиланню. |
comment | string | Коментар користувача до короткого посилання. |
| Код | Опис |
|---|---|
| 0 | Короткі посилання кампанії успішно отримані. |
| 2 | Якщо кампанію не знайдено. |
https://api.mobizon.ua/service/Link/GetStats
Цей метод призначений для отримання статистики кліків для одного або декількох коротких посилань за їх ID.
Дані можуть бути згруповані за місяцями, днями, годинами, хвилинами.
| Параметр | Тип | Опис |
|---|---|---|
ids | array | Ідентифікатори посилань. Максимальна кількість ID у запиті – 5. Синтаксис параметра: ids[] для кожного ідентифікатора. |
type | string | Тип запитуваної статистики. Дозволяє отримати дані в різні часові проміжки: monthly – кількість кліків за місяцями. Максимальний інтервал для отримання статистики – 3 роки; daily – кількість кліків за днями. Максимальний інтервал для отримання статистики – 90 днів; hourly – кількість кліків за годинами. Максимальний інтервал для отримання статистики – 1 тиждень; minute – кількість кліків за хвилинами. Максимальний інтервал для отримання статистики – 3 години. |
criteria | array | Критерії пошуку (Див. таблицю Критерії пошуку). |
Пошук статистичних даних формується виходячи з указаних дати і часу.
| Параметр | Тип | Опис |
|---|---|---|
criteria[dateFrom] | string | Витягувати статистику, починаючи з зазначеної дати і часу. Формат: РРРР-ММ-ДД ГГ:ХХ:СС. |
criteria[dateTo] | string | Витягувати статистику до зазначеної дати і часу. Формат: РРРР-ММ-ДД ГГ:ХХ:СС. |
Важливо: якщо критерії пошуку dateFrom і dateTo не встановлені, то статистика поля type буде витягуватися за останній максимально можливий інтервал.
Якщо встановлено тільки один критерій dateFrom або проміжок часу між dateFrom і dateTo перевищує максимально допустимий інтервал, то статистика буде витягуватися за максимально допустимий інтервал, починаючи з дати dateFrom.
Якщо встановлено тільки критерій dateTo, то статистика буде витягуватися за максимально можливий період до дати dateTo.
Масив даних:
| Поле | Тип | Опис |
|---|---|---|
items | array | Дані статистики. |
totals | string | Загальна кількість кліків за запитуваний період. |
| Код | Опис |
|---|---|
| 0 | Статистика успішно отримана. |
| 12 | Якщо вказано більше 5 ідентифікаторів посилань або невірно вказано тип статистики. |
curl -X POST \
'https://api.mobizon.ua/service/link/getStats?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'ids%5B0%5D=123&ids%5B1%5D=455&ids%5B2%5D=567&type=monthly&criteria%5BdateFrom%5D=2018-01-21+13%3A30%3A00'
var data = "ids%5B0%5D=123&ids%5B1%5D=455&ids%5B2%5D=567&type=monthly&criteria%5BdateFrom%5D=2018-01-21+13%3A30%3A00";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/getStats?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'getStats',
array(
//ідентифікатори посилань
'ids' => array(
'123',
'455',
'567'
),
//тип статистики
'type' => 'monthly',
//критерії пошуку
'criteria' => array(
'dateFrom' => '2018-01-21 13:30:00'
)
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.ua/service/Link/List
Цей метод дозволяє отримати список створених коротких посилань. Пошук може бути здійснений за ID та даними з полів короткого посилання.
| Параметр | Тип | Опис |
|---|---|---|
criteria | array | Критерії пошуку (див. таблицю Критерії пошуку). |
pagination | array | Параметри посторінкового виводу (див. таблицю Параметри посторінкового виводу). |
sort | array | Параметри сортування (див. таблицю Параметри сортування). |
Інформація про поля короткого посилання, за якими здійснюється пошук. Для пошуку можна використовувати як одне поле, так і сукупність полів.
| Параметр | Тип | Опис |
|---|---|---|
criteria[status] | integer | Пошук за статусом короткого посилання: 0 – посилання неактивне; 1 – посилання активне. |
criteria[moderatorStatus] | integer | Пошук за статусом модерації посилання: 0 – заблоковано; 1 – дозволено. |
criteria[createTsFrom] | datetime | Пошук за датою створення посилання, починаючи з вказаної дати. Формат: РРРР-ММ-ДД. |
criteria[createTsTo] | datetime | Пошук за датою і часом створення посилання до вказаної дати і часу. Формат: РРРР-ММ-ДД ГГ:ХХ:СС. |
criteria[query] | string | Пошук за різними атрибутами посилання. Пошук може бути здійснений за: Кодом короткого посилання; Кодом відстеження отримувача; Коментарем до короткого посилання. |
Ці параметри призначені для структурованого (часткового) виводу запитуваної інформації.
| Параметр | Тип | Опис |
|---|---|---|
pagination[pageSize] | integer | Кількість відображуваних елементів на сторінці (25, 50, 100). |
pagination[currentPage] | integer | Поточна сторінка Нумерація сторінок починається з 0. |
За допомогою цих параметрів можна відсортувати результати пошуку за одним з полів у порядку зростання (ASC) або спадання (DESC).
Наприклад:
Сортування за кодом короткого посилання у порядку зростання – sort[code]=ASC.
Сортування за оригінальним посиланням у порядку спадання – sort[fullLink]=DESC.
| Параметр | Опис |
|---|---|
sort[createTs] | Сортування за датою і часом створення посилання. Формат: РРРР-ММ-ДД ГГ-ХХ-СС. |
sort[expirationDate] | Сортування за датою закінчення дії посилання. Формат: РРРР-ММ-ДД. |
sort[clickCnt] | Сортування за кількістю кліків. |
sort[code] | Сортування за кодом короткого посилання. |
sort[fullLink] | Сортування за оригінальним посиланням. |
Масив даних:
| Поле | Тип | Опис |
|---|---|---|
items | array | Список знайдених посилань. Опис полів коротких посилань дивіться в описі методу Link/Get. |
totalItemCount | integer | Загальна кількість знайдених елементів. |
curl -X POST \
'https://api.mobizon.ua/service/link/list?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'criteria%5Bstatus%5D=1&criteria%5BmoderatorStatus%5D=1&pagination%5BcurrentPage%5D=2&pagination%5BpageSize%5D=50&sort%5BclickCnt%5D=ASC'
var data = "criteria%5Bstatus%5D=1&criteria%5BmoderatorStatus%5D=1&pagination%5BcurrentPage%5D=2&pagination%5BpageSize%5D=50&sort%5BclickCnt%5D=ASC";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/list?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'list',
array(
//критерії пошуку
'criteria' => array(
//тільки активні посилання
'status' => '1',
//посилання дозволені модератором
'moderatorStatus' => '1'
),
//параметри посторінкового виводу
'pagination' => array(
//поточна сторінка
'currentPage' => '2',
//кількість відображуваних елементів на сторінці
'pageSize' => '50'
),
//параметри сортування
'sort' => array(
//сортування за кількістю кліків за зростанням
'clickCnt' => 'ASC'
)
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.ua/service/Link/Update
Цей метод дозволяє змінити параметри створеного короткого посилання.
| Параметр | Тип | Опис |
|---|---|---|
id | integer | Ідентифікатор посилання. |
data | integer | Редаговані параметри посилання зазначені в таблиці Параметри посилання. |
| Параметр | Тип | Опис |
|---|---|---|
data[status] | integer | Статус короткого посилання: 0 – посилання неактивне; 1 – посилання активне. |
data[expirationDate] | date | Дата закінчення дії короткого посилання. Формат: РРРР-ММ-ДД.Якщо значення не передано – строк дії посилання буде необмеженим. |
data[comment] | string | Коментар до посилання. Максимальна довжина коментаря – 255 символів. |
string – Коротке посилання.
| Код | Опис |
|---|---|
| 0 | Параметри успішно змінено. |
| 1 | Якщо які-небудь параметри містять невірні значення. |
| 2 | Якщо посилання з указаним ідентифікатором не знайдено. |
curl -X POST \
'https://api.mobizon.ua/service/link/update?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'id=123&data%5Bstatus%5D=0'
var data = "id=123&data%5Bstatus%5D=0";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.ua/service/link/update?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.ua');
// Виклик АПІ методу
if ($api->call(
'link',
'update',
array(
//ідентифікатор посилання
'id' => '123',
'data' => array(
//статус посилання
'status' => '0'
)
)
)
) {
// Отримання результату виконання методу
$result = $api->getData();
} else {
// Під час виконання сталася помилка, вивід коду помилки і тексту повідомлення
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}