TechArticle

客户 API

从可信外部系统获取并创建 u0life 客户。

List clients

Use the clients endpoint when an external system needs to show, match or reuse clients already owned by the API key user.

GET /public-api/v1/clients/ Returns active clients for the API key owner. 
curl -X GET "https://u0life.com/public-api/v1/clients/?limit=50&offset=0" \
  -H "Authorization: Bearer u0_live_your_key"

Create client

Create a client before sending tasks, time or money records that should be attached to that client.

POST /public-api/v1/clients/ Creates one client for the API key owner. 
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": "Client created from CRM",
    "email": "team@example.com",
    "phone": "+1 555 0100",
    "site": "https://example.com",
    "color": "#3b82f6",
    "hourly_rate": 120,
    "hourly_rate_cur": "USD"
  }'

Fields

title required for POST Client title, up to 191 characters.
description optional Plain text client note.
email optional Client email address.
phone optional Client phone number.
site optional Client website URL.
telegram, instagram, whatsapp, facebook, linkedin, x optional Social/contact identifiers.
address optional Client address.
color optional Display color, for example #3b82f6.
hourly_rate optional Default client hourly rate as a number.
hourly_rate_cur optional Currency code or label for the hourly rate.
limit, offset optional for GET Pagination controls. Limit is capped at 100.

Responses

{"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"}}