Integration API · Клієнти

Список клієнтів

GEThttps://{store}/api/v1/integrations/customers

Акаунти покупців магазину в порядку id, з курсорною пагінацією, як у замовлень. updated_since забирає зміни від останньої синхронізації.

customers:read дає доступ до персональних даних — видавайте його лише системам, яким він потрібен. Нові реєстрації також приходять вебхуком customer.created.

Ключ інтеграції з правом customers:read: Authorization: Bearer {key}.

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

updated_sincestring

Лише клієнти, змінені в цей час або пізніше (YYYY-MM-DD HH:MM:SS).

cursorinteger

Клієнти з id, більшим за цей.

limitinteger

Розмір сторінки: за замовчуванням 15, максимум 50.

Відповіді

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"
        }
    ],
    "next_cursor": 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
}

{ "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" } ], "next_cursor": null }