Idempotency-Key дає змогу безпечно повторити виклик Store API.
Як це працює
Додайте заголовокIdempotency-Key (до 255 символів) до запиту на створення або дію. PapelShip зберігає першу відповідь протягом 24 годин. Повторний запит із тим самим ключем і тим самим тілом отримує збережену відповідь, а не виконується знову.
Ендпоінти, які його приймають
Ключ працює на ендпоінтах створення та дій Store API, зокрема:POST /invoices(створення замовлення)POST /invoices/{invoiceId}/papelpay(запуск оплати карткою)POST /invoices/{invoiceId}/completeіPOST /invoices/{invoiceId}/refundPOST /orders/{invoiceId}/shipmentsPOST /productsіPOST /coupons
Рекомендації
- Генеруйте один ключ на замовлення, а не на запит. Добре підходить ID вашого власного замовлення.
- Зберігайте ключ разом із замовленням, щоб кожна повторна спроба використовувала його знову.
- Ніколи не використовуйте ключ повторно для іншого замовлення чи іншої суми.