Рефсейлс API
Клиенты

Получить клиента

GET
/api/v1/customers/{id}

Один клиент по ID Рефсейлс. Право: customers:read.

Авторизация

bearerApiKey
АвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API.

Где: header

Параметры пути

id*string

ID клиента в Рефсейлс.

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/customers/string"
{  "data": {    "id": "2c8e4a1f-9b3d-4f7e-a6c0-5d1b8e3f2a96",    "name": "Анна Смирнова",    "email": "anna@example.ru",    "phone": "+7 (916) 123-45-67",    "phoneDigits": "79161234567",    "source": "order",    "notes": "Предпочитает доставку после 18:00",    "totalOrders": 4,    "totalRevenue": 1164000,    "firstSeenAt": "2026-03-02T10:21:00.000Z",    "lastOrderAt": "2026-09-12T09:41:07.000Z",    "createdAt": "2026-03-02T10:21:00.000Z",    "updatedAt": "2026-09-12T09:41:07.000Z"  }}

Список клиентов GET

Клиенты магазина. Удалённые клиенты в список не попадают. Выручка в копейках. Право: customers:read.

Статусы заказов GET

Статусы заказов магазина с системными кодами. Коды передавайте в status при изменении заказа. Список короткий, поэтому приходит одной страницей. Право: references:read.