Перейти до основного вмісту
Мережеві збої трапляються. Коли запит завершується тайм-аутом, ви не можете знати, чи створив PapelShip замовлення. Заголовок Idempotency-Key дає змогу безпечно повторити виклик Store API.

Як це працює

Додайте заголовок Idempotency-Key (до 255 символів) до запиту на створення або дію. PapelShip зберігає першу відповідь протягом 24 годин. Повторний запит із тим самим ключем і тим самим тілом отримує збережену відповідь, а не виконується знову.

Ендпоінти, які його приймають

Ключ працює на ендпоінтах створення та дій Store API, зокрема:
  • POST /invoices (створення замовлення)
  • POST /invoices/{invoiceId}/papelpay (запуск оплати карткою)
  • POST /invoices/{invoiceId}/complete і POST /invoices/{invoiceId}/refund
  • POST /orders/{invoiceId}/shipments
  • POST /products і POST /coupons

Рекомендації

  • Генеруйте один ключ на замовлення, а не на запит. Добре підходить ID вашого власного замовлення.
  • Зберігайте ключ разом із замовленням, щоб кожна повторна спроба використовувала його знову.
  • Ніколи не використовуйте ключ повторно для іншого замовлення чи іншої суми.