用途限定權杖與撤銷

不在權杖中儲存個人資料

示例採用不可預測的不透明權杖，由伺服器管理範圍及有效期。除權杖外，還要求接收方驗證身份，以降低被盜影響。

token_hash

用於匹配權杖的查詢值。不要在日誌或普通管理介面中儲存原始權杖。

audience

獲准的接收方。拒絕其他整合合作方使用。

scope / purpose

獲准的資料與用途。預設不授予廣泛許可權。

resource_ref

訂單或配送記錄。防止用於其他記錄。

expires_at / remaining_uses

有效期與使用限制。伺服器拒絕過期或已消耗的權杖。

單次使用與回應遺失

ID 參照已保存的地址。權杖為特定訂單、應用與欄位增加存取條件，兩者都應保護。單次權杖在成功取得後消耗，不保證重播相同回應。回應遺失時，應先確認處理狀態再決定是否重新簽發。

到期、撤銷與變更

更正時註冊新地址，而非直接修改。查詢目前繫結，將其 Version 作為 expectedVersion 變更訂單，再核發新版本權杖。訂單版本變更會封鎖所有舊版本權杖。同版本追加核發不會撤銷現有權杖。刪除舊地址前檢查其他訂單與保留要求。已取得的明文無法收回。

狀態轉換

active → consumed / expired / revoked。不得重新啟用已撤銷狀態。

快取

限制撤銷傳播延遲。高風險操作必須驗證權威狀態。

侷限

撤銷無法收回合作方已讀取的個人資料。

DATA / INTEGRATION EXAMPLE

資料與整合示例

這些示例用於說明設計。欄位名及值僅供演示，並非可執行的 API 參考。

{
  "operation": "Delivery token issuance example",
  "request": {
    "proxy_id": "nym_example_01",
    "resource_ref": "order_example_01",
    "audience": "carrier-a",
    "scope": [
      "shipping.address.read"
    ],
    "expires_in_seconds": 600,
    "max_uses": 1
  },
  "response": {
    "token": "tok_example_not_a_real_token",
    "expires_in_seconds": 600
  }
}

600 秒與一次使用僅為示例。簽名 JWT 本身不保證提前撤銷或單次使用，還需額外狀態管理。

相關技術設計

為您的業務流程設計整合。

梳理留存資料、合作方及必要操作，尋找減少暴露的方法。