Verze a změny

Aktuální major verze je v1 a je součástí URL. EasyPick v rámci stejné major verze přidává pouze zpětně kompatibilní změny, například nové volitelné pole, nový webhook event nebo nový endpoint.

Integrace musí ignorovat neznámá JSON pole a nesmí předpokládat pevné pořadí polí. Nová hodnota enumu nebo odstranění či změna významu pole vyžaduje novou major verzi.

1.1.0

• Veřejné odpovědi a webhooky rozlišují status zásilky a fyzický compartment_state schránky.
• Webhook door_available vzniká po každém skutečném uvolnění schránky.
• Nový idempotentní endpoint POST /shipments/{shipment_id}/retry vytváří další pokus po bezpečném vyřešení stavu fault.
• Odpovědi a webhooky obsahují attempt_number a retry_of_shipment_id pro rozlišení pokusů.

1.0.0

• Veřejný namespace /v1 a Bearer API klíče ep_live_ / ep_test_.
• Atomická rezervace schránky s idempotencí podle external_order_id.
• Auditované opětovné zobrazení PINu.
• Podepsané webhooky s doručením alespoň jednou.
• Izolovaný sandbox s deterministickými přechody zásilky.
• České a anglické OpenAPI schéma.