Tovább a tartalomhoz
Dokumentáció ehhez: TrustOrder
ENuptools.io
Markdown

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.

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ó
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.

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.

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.