API заказов — Tallker API

curl -X POST https://tallker.com/api/v1/public/orders \ -H "Authorization: Bearer tk_live_..." -H "Idempotency-Key: order-43829-v1" \ -H "Content-Type: application/json" \ -d '{"external_id":"ORDER-43829","status":"new","customer":{"external_id":"CUSTOMER-18452","email":"ivan@example.com"},"amount":5320.50,"currency":"RUB","items":[]}'

POST/api/v1/public/ordersscope: orders:write

Как это работает

1Сформируйте уникальный Idempotency-Key для версии события заказа.
2Передайте заказ и вложенный объект customer.
3При изменении статуса отправьте заказ повторно с новым Idempotency-Key.

Примеры

curl -X POST https://tallker.com/api/v1/public/orders \
  -H "Authorization: Bearer tk_live_..." -H "Idempotency-Key: order-43829-v1" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"ORDER-43829","status":"new","customer":{"external_id":"CUSTOMER-18452","email":"ivan@example.com"},"amount":5320.50,"currency":"RUB","items":[]}'

Параметры и требования

Параметр	Требование	Описание
`external_id`	обязательно	ID заказа в вашей системе
`status`	обязательно	new, processing, paid, shipping, completed или cancelled
`customer`	обязательно	Контакт с external_id и идентифицирующими данными
`amount / currency`	обязательно	Сумма ≥ 0 и трёхбуквенный код валюты
`items / metadata`	необязательно	Позиции заказа и произвольный JSON

Результат

{"id":"…","external_id":"ORDER-43829","contact_id":"…","deal_id":"…","status":"new","created":true}

Лимиты и идемпотентность

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

Безопасность

Чтение: GET /api/v1/public/orders/{external_id}, scope orders:read.

Idempotency-Key хранится 24 часа. Повтор с другим телом вернёт HTTP 409.

OpenAPI 3.1