Visszajelzések
A TrustOrder a csatlakozó boltok visszajelzéseiből dolgozik. Minden rendelést jelezz vissza, amint kiderült a kimenetele: delivered, ha a vásárló átvette, refused, ha nem.
Egy rendelés
Szekció neve “Egy rendelés”PUT /signals/{order_ref}Az order_ref a saját rendelés-azonosítód, 1-128 karakter vezérlőkarakterek nélkül, az útvonalban URL-kódolva (a / %2F-ként).
{ "outcome": "refused", "email_hash": "8cd79ce2224abde026ddc67563fe5edb8b5eb41846c63cd550a76ea76cc2eddd", "phone_hash": "038e5821814169825ae568bfefdb18ca31d4d2e0a0f5941b6da27df45d50ddf4", "address_hash": null, "occurred_at": "2026-11-01T14:03:00Z"}| Mező | |
|---|---|
outcome |
delivered vagy refused, kötelező |
email_hash, phone_hash, address_hash |
legalább egy kötelező |
occurred_at |
RFC 3339; alapból a mostani idő; legfeljebb 5 perccel a jövőben és legfeljebb 1095 napos |
A hívás idempotens: ugyanaz az order_ref újra küldve egy visszajelzés marad, az utolsó számít. A válasz megmondja, mi történt:
result |
Jelentés |
|---|---|
stored |
elmentve vagy módosítva |
unchanged |
ugyanez a visszajelzés már megvolt |
voided |
a visszajelzést vitatás után érvénytelenítették; már nem számít, és nem módosítható |
Visszavonás
Szekció neve “Visszavonás”DELETE /signals/{order_ref}Akkor használd, ha a rendelés visszakerül, például teljesítettből feldolgozás alattiba. A válasz 204; 404, ha nincs ilyen visszajelzés, és 409 érvénytelenítettnél.
Sok rendelés egyszerre
Szekció neve “Sok rendelés egyszerre”POST /signals/batch{ "signals": [ { "order_ref": "1001", "outcome": "delivered", "email_hash": "8cd79ce2…" }, { "order_ref": "1002", "outcome": "refused", "email_hash": "8cd79ce2…" } ]}1-500 sor, mindegyik a fenti mezőkkel és az order_ref-fel; a kérés legfeljebb 1 MiB. Minden sort külön kezel, és a válasz a küldés sorrendjében sorolja fel őket:
{ "results": [ { "order_ref": "1001", "result": "stored" }, { "order_ref": "1002", "error_code": "INVALID_REQUEST" } ]}Az érvénytelen sor INVALID_REQUEST-et kap, és nem állítja meg a többit. Az INTERNAL sor nem mentődött el; küldd el újra a batch-et, biztonságosan ismételhető. Induláskor ezzel töltheted be a korábbi rendeléseket: az 1095 napnál nem régebbi visszajelzések számítanak.
Teszt és éles
Szekció neve “Teszt és éles”A visszajelzés a kulcs környezetébe kerül. A teszt kulccsal küldöttek soha nem hatnak az éles javaslatokra. Az új fiók visszajelzései azonnal tárolódnak, és a jóváhagyástól számítanak.