Verziókezelés
A kereskedői API és dokumentumai az 1-es verziót képviselik, és a v1-en belül csak bővülnek. A v1-re írt integráció tovább működik.
Az elérési utak, mezőnevek, hibakódok, fejlécnevek és kódpéldák angolul maradnak: ezek jelentik a szerződést.
Mi változhat a v1-en belül
- Egy új opcionális mező egy válaszban, egy kérésben vagy a rendelési dokumentumban.
- Egy új útvonal, egy új hibakód, egy új webhookesemény vagy egy új érték az engedélyezett értékek listájában.
- Egy új aláírási séma a
v1=mellett aCutOptim-Signaturefejlécben; a fogadók figyelmen kívül hagyják az ismeretlen sémákat.
Mi nem változik soha a v1-en belül
- Egy mező sem tűnik el, nem nevezik át, és nem változtatja a jelentését.
- Egy útvonal sem változtatja az elérési útját, a kulcsát vagy a válasza alakját.
- Egy hibakód megtartja a jelentését.
Írj toleráns olvasót
Hagyd figyelmen kívül az ismeretlen mezőket, az ismeretlen hibakódot kezeld a HTTP-státusza alapján, és az olyan webhookesemény-típust, amelyre nem iratkoztál fel, fogadd el 2xx válasszal. A rendelési dokumentum és minden webhooktörzs schemaVersion értéke 1.
Törést okozó változás
Egy törést okozó változás egy új dokumentum (order.v2) vagy egy új útvonal (/cfg/v2) lenne a v1 mellett, soha nem a v1 átírása. A Változásnaplóban jelentenénk be.
Szándékosan nincs itt "kipróbálom" gomb: a titkos kulcs a szerveredre való, soha nem a böngészőbe. A demó webshop elejétől végéig megmutatja a beágyazást és a rendelés átadását.
Jogi tudnivalókKonfigurátor feltételek (EN) ·Adatfeldolgozási szerződés (EN) ·Vásárlói adatvédelmi tájékoztató ·Harmadik féltől származó licencek (EN)