Подключиться

API

Сделать первый безопасный запрос.

Ключ определяет компанию и полномочия. Tenant ID не передаётся из клиентского body и не может быть подменён.

  1. 01

    Выпустите credential

    В кабинете задайте название и scopes. Скопируйте loy_live_… сразу: база хранит только digest, повторно показать секрет невозможно.

  2. 02

    Проверьте доступность

    Health endpoint не требует ключа и подходит для проверки маршрута.

    curl https://api.landlancer.online/health
  3. 03

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

    Номер нормализуется в российский E.164. Если policy требует регистрацию с OTP, сначала подтвердите ENROLLMENT challenge.

    curl -X POST https://api.landlancer.online/v1/customers \
  -H "Authorization: Bearer $LOYALTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+79123456789","firstName":"Анна"}'
  4. 04

    Меняйте бонусы идемпотентно

    Сгенерируйте ключ операции и повторяйте тот же ключ только с идентичным payload. Это защищает от двойного начисления при сетевом retry.

    Idempotency-Key: adjustment-01J…
amount: "250.00"
  5. 05

    Подпишите события

    Webhook worker подписывает raw body, делает retry с backoff и отправляет неуспешные события в dead-letter. Endpoint должен быть HTTPS и заранее разрешён оператором.

Следующий шаг

Создайте аккаунт и повторите сценарий на своих данных.

Создать аккаунт