Integration API · Клієнти
Отримати клієнта
GEThttps://{store}/api/v1/integrations/customers/{id}
Один клієнт: поля, як у списку, його адреси й 20 останніх оформлених замовлень.
Ключ інтеграції з правом
customers:read: Authorization: Bearer {key}.
Параметри шляху
idintegerобов'язковийId клієнта.
Відповіді
200Клієнт.
{
"data": {
"id": 318,
"first_name": "Олена",
"last_name": "Коваль",
"company_name": null,
"email": "[email protected]",
"orders_count": 3,
"created_at": "2026-09-14 11:02:40",
"updated_at": "2026-10-12 14:03:11",
"addresses": [
{
"first_name": "Олена",
"last_name": "Коваль",
"company_name": null,
"line_one": "Відділення №1",
"line_two": null,
"city": "Київ",
"postcode": "01001",
"country": "UA",
"contact_email": "[email protected]",
"contact_phone": "+380671234567",
"shipping_default": true
}
],
"recent_orders": [
{
"reference": "2026-001044",
"status": "dispatched",
"total": 214000,
"currency_code": "UAH",
"placed_at": "2026-10-12 14:03:11"
}
]
}
} 404Клієнта з таким id немає.
{
"code": "not_found",
"message": "not_found",
"field": null
} 401Ключа немає, він невідомий або відкликаний.
{
"code": "unauthenticated",
"message": "Integration key is inactive.",
"field": null
} 403У ключа немає права customers:read, або тариф магазину без доступу до API.
{
"code": "forbidden",
"message": "Integration key cannot customers:read.",
"field": null
} 422Поле має помилку; його назва — у field.
{
"code": "validation_error",
"message": "name is required.",
"field": "name"
} 429Понад 60 запитів за хвилину для цього ключа. Зачекайте Retry-After секунд.
{
"code": "rate_limited",
"message": "Too many integration requests.",
"field": null
}