すべてのガイド

ユースケースと導入手順

レポート、証拠、製品アクションを接続する

受付、署名付きコンテキスト、限定された証拠サービス、冪等なコールバックを順番に接続します。

対象
製品開発、Trust & Safety、セキュリティ、インテグレーション担当
最新ガイド
2026年8月29日更新

01

出発点

ユーザー、メッセージ、出品、ワークスペースの正本は自社製品に残します。Safest Resolve は明示的なレポートを受け、公開済みワークフローに必要な情報だけを要求します。

02

守る条件

  • サーバーキーをブラウザーに置く、または未署名の参照を信頼すること。
  • 必要な数項目ではなく広い記録を複製すること。
  • 冪等キーなしでアクションを再試行し、結果確認前に閉じること。

03

手順

  1. 入口を /widget.js、/report/、/v1/reports/server から選びます。
  2. 最小権限のインテグレーションを作り、資格情報はバックエンドに置きます。Widget には短時間のコンテキストトークンを発行します。
  3. 構造化した申し立てを冪等キー付きで送信し、返されたレポート参照を保存します。
  4. 証拠コンポーネントに入力許可、限定スキーマ、タイムアウト、不変バージョンを定義し、署名検証後に型付き結果を返します。
  5. evidence_callback と action_callback に別のインテグレーションを作ります。
  6. ルーティング fixture と revision、ビジュアルワークフローを公開し、そのバージョンをキューに固定します。
  7. 成功、重複、タイムアウト、アクション再試行、メッセージ、人の claim、異議申立てをテストします。

04

運用上の境界

不透明な参照IDを使います。必須証拠の失敗は判断を止め、重要なアクションは人を待ち、呼び出しは冪等で、各コールバックは明示的な状態を記録します。

05

データ交換

Safest Resolve は安定した参照を署名付き・期限付きで送ります。自社サービスは許可された項目だけを返します。アクションは別の署名接続と安定キーを使い、コールバックが実結果を記録します。

安定した参照ID署名付きリクエスト型付きの結果

06

確認

レポートはバージョン付きキューと耐久ワークフローを通ります。製品DBを複製せず、証拠、担当者、判断、アクション、結果、メッセージ、異議申立てを確認できます。

07

導入時の質問

既存のフォームを使えますか?+

はい。構造化した出力をサーバー API に送り、外部参照を保持します。

コールバック権限はどの資格情報に与えますか?+

別々の最小権限インテグレーションを使います。evidence_callback と action_callback は submit_reports に含まれません。

Safest Resolve

チームが最初に運用するワークフローを設計しましょう。

レポートの入口、必要な証拠、判断者、製品アクション、通知、異議申立て経路から始めます。