u0life API

Обзор First-Party REST API

First-Party REST API u0life позволяет внешним системам, пользовательским скриптам и сервисам автоматизации работать с записями владельца API-ключа. Все рабочие endpoints сгруппированы под версией /v1/ и поддерживают полный CRUD для задач, клиентов и проектов.

Используйте API вместе с компонентами сайтов для серверной автоматизации: CRM, веб-формы, очереди тикетов, календарные сервисы, скрипты и боты, которым нужно добавлять и синхронизировать данные в едином пространстве u0life.

• Создайте API-ключ в разделе интеграций u0life (ключ начинается с u0_live_).
• Передавайте ключ в заголовке Authorization: Bearer u0_live_your_key или X-API-Key: u0_live_your_key.
• Права доступа регулируются скоупами: tasks:*, tasks:read, tasks:write, clients:*, projects:*.
• Отправляйте и получайте JSON с заголовком Content-Type: application/json.
• ID клиентов, проектов и категорий должны принадлежать владельцу API-ключа.

Базовый запрос создания задачи

curl -X POST https://u0life.com/v1/tasks \
  -H "Authorization: Bearer u0_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title":"Позвонить клиенту","description":"Создано из внешнего API","priority":2}'

Запрос списка задач

curl -X GET "https://u0life.com/v1/tasks?limit=50&offset=0&status=0&active=1" \
  -H "Authorization: Bearer u0_live_your_key"

Базовый запрос клиентов

curl -X GET "https://u0life.com/v1/clients?limit=50&offset=0" \
  -H "Authorization: Bearer u0_live_your_key"

Ответы и ошибки

При успешном запросе API возвращает HTTP 200/201, success: true и объект data с полями записи. При завершении задачи возвращается блок геймификации с опытом и наградами. Ошибки валидации и доступа возвращают success: false с кодом ошибки и пояснением.

{"success":true,"data":{"task":{"id":123,"title":"Позвонить клиенту","status":0,"active":1}}}
{"success":false,"error":{"code":"TITLE_REQUIRED","message":"Task title is required."}}