API підписок, оплати й підтримки
Читайте плани й використання, створюйте оплату, переглядайте транзакції, скасовуйте підписки та надсилайте звернення.
Перед початком
Базова адреса REST — https://tasker.fit/api. Створіть активний токен у профілі та передавайте Authorization: Bearer <your-api-token>. Замініть ID прикладів значеннями, отриманими для свого облікового запису.
Планування робочого процесу
Тарифні плани публічні для читання; підписка, оплата, транзакції та скасування потребують входу. Використовуйте повернуті код плану й умови замість фіксованих цін. Оплата повертає checkout_url та order_reference. Відкриття сторінки не означає успішної оплати: перевіряйте підписку й транзакції.
Скасування приймає order_reference, а вимкнення підписки — авторизований POST без JSON. Ці дії мають фінансові наслідки й потребують рішення користувача. Підтримка стосується самого Tasker; дефект проєкту слід оформлювати як завдання-помилку чи звіт QA.
Приклад
Читайте плани й використання, створюйте оплату, переглядайте транзакції, скасовуйте підписки та надсилайте звернення.
Покрокові інструкції / 1
Процес інтеграції
Прочитайте плани й поточну підписку для актуальних варіантів і використання.
Після вибору користувача створіть оплату з plan_code та відкрийте checkout_url.
Збережіть order_reference. Перевіряйте результат у підписці чи транзакціях; у підтримці додавайте конкретний контекст.
Очікуваний результат: Прочитайте об’єкт data та збережіть ідентифікатори для наступних запитів. Перевіряйте HTTP-статус перед підтвердженням успіху запису.
Endpoint та приклади запитів
ID, токени й дати в прикладах замініть власними значеннями. Кожен приклад показує поля для конкретної дії, а не повну схему відповіді.
| Метод | Маршрут | Дія |
|---|---|---|
| GET | /subscription/tariff-plans/ | Отримати тарифні плани |
| GET | /subscription/current/ | Отримати поточний план і використання |
| GET | /subscription/transactions/ | Список транзакцій |
| POST | /subscription/checkout/ | Створити оплату плану |
| POST | /subscription/cancel/ | Скасувати оплату підписки |
| POST | /subscription/disable/ | Вимкнути підписку учасника |
| GET | /ticket/ | Список власних звернень |
| POST | /ticket/ | Надіслати звернення |
/api/subscription/tariff-plans/Отримати тарифні плани
Без Bearer-заголовка; виконайте вимоги тіла запиту.
Приклад cURL
curl --request GET 'https://tasker.fit/api/subscription/tariff-plans/'/api/subscription/current/Отримати поточний план і використання
Потрібна автентифікація та права на операцію.
Приклад cURL
curl --request GET 'https://tasker.fit/api/subscription/current/' \
--header 'Authorization: Bearer <your-api-token>'/api/subscription/transactions/Список транзакцій
Потрібна автентифікація та права на операцію.
Параметри URL (приклад)
{
"page": 1,
"limit": 20
}Додаткові поля: order_reference, q
Приклад cURL
curl --request GET 'https://tasker.fit/api/subscription/transactions/?page=1&limit=20' \
--header 'Authorization: Bearer <your-api-token>'/api/subscription/checkout/Створити оплату плану
Потрібна автентифікація та права на операцію.
Тіло JSON (приклад)
{
"plan_code": "<plan-code>"
}Приклад cURL
curl --request POST 'https://tasker.fit/api/subscription/checkout/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"plan_code": "<plan-code>"
}'/api/subscription/cancel/Скасувати оплату підписки
Потрібна автентифікація та права на операцію.
Тіло JSON (приклад)
{
"order_reference": "<order-reference>"
}Приклад cURL
curl --request POST 'https://tasker.fit/api/subscription/cancel/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"order_reference": "<order-reference>"
}'/api/subscription/disable/Вимкнути підписку учасника
Потрібна автентифікація та права на операцію.
Приклад cURL
curl --request POST 'https://tasker.fit/api/subscription/disable/' \
--header 'Authorization: Bearer <your-api-token>'/api/ticket/Список власних звернень
Потрібна автентифікація та права на операцію.
Параметри URL (приклад)
{
"page": 1,
"limit": 20
}Приклад cURL
curl --request GET 'https://tasker.fit/api/ticket/?page=1&limit=20' \
--header 'Authorization: Bearer <your-api-token>'/api/ticket/Надіслати звернення
Потрібна автентифікація та права на операцію.
Тіло JSON (приклад)
{
"type": "question",
"message": "How can our team set up QA sessions?"
}Приклад cURL
curl --request POST 'https://tasker.fit/api/ticket/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"type": "question",
"message": "How can our team set up QA sessions?"
}'Поради й вирішення проблем
- Приклади показують основні поля запиту, а не всі додаткові поля чи повну схему відповіді. Query-поля передавайте в URL, JSON-поля — у тілі. Зберігайте кінцеві слеші адрес.
- Типи звернень: question, bug, advice. Webhook платіжного провайдера не є загальними клієнтськими API й не включені до прикладів.
Поширені запитання
Чи можна використовувати приклади з будь-яким обліковим записом?
Читати й змінювати можна лише доступні токену ресурси. Використовуйте отримані ID просторів, дошок, завдань і числових ресурсів; демонстраційні значення є заповнювачами.
Що робити інтеграції при помилці запиту?
Перевірте HTTP-статус і відповідь помилки. Перевірте ID, обов’язкові поля, активність, строк токена та права. Не повторюйте POST наосліп: попередня спроба могла вже створити ресурс.