TechArticle

API клиентов

Получайте список клиентов и создавайте клиентов u0life из доверенных внешних систем.

Получение клиентов

Используйте endpoint клиентов, когда внешней системе нужно показать, сопоставить или повторно использовать клиентов владельца API-ключа.

GET /public-api/v1/clients/ Возвращает активных клиентов владельца API-ключа. 
curl -X GET "https://u0life.com/public-api/v1/clients/?limit=50&offset=0" \
  -H "Authorization: Bearer u0_live_your_key"

Создание клиента

Создавайте клиента до отправки задач, времени или денежных записей, которые должны быть привязаны к этому клиенту.

POST /public-api/v1/clients/ Создаёт одного клиента для владельца API-ключа. 
curl -X POST https://u0life.com/public-api/v1/clients/ \
  -H "Authorization: Bearer u0_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Acme Studio",
    "description": "Клиент создан из CRM",
    "email": "team@example.com",
    "phone": "+1 555 0100",
    "site": "https://example.com",
    "color": "#3b82f6",
    "hourly_rate": 120,
    "hourly_rate_cur": "USD"
  }'

Поля

title обязательно для POST Название клиента, до 191 символа.
description опционально Текстовая заметка о клиенте.
email опционально Email клиента.
phone опционально Телефон клиента.
site опционально Сайт клиента.
telegram, instagram, whatsapp, facebook, linkedin, x опционально Социальные сети и контакты.
address опционально Адрес клиента.
color опционально Цвет отображения, например #3b82f6.
hourly_rate опционально Базовая часовая ставка клиента числом.
hourly_rate_cur опционально Код или подпись валюты часовой ставки.
limit, offset опционально для GET Параметры пагинации. Limit ограничен 100 записями.

Ответы

{"success":true,"data":{"items":[{"id":15,"type":"client","title":"Acme Studio"}],"limit":50,"offset":0}}
{"success":true,"data":{"id":15,"type":"client","title":"Acme Studio"}}