すべてのガイド
ユースケースと導入手順
レポート、証拠、製品アクションを接続する
受付、署名付きコンテキスト、限定された証拠サービス、冪等なコールバックを順番に接続します。
- 対象
- 製品開発、Trust & Safety、セキュリティ、インテグレーション担当
- 最新ガイド
- 2026年8月29日更新
01
出発点
ユーザー、メッセージ、出品、ワークスペースの正本は自社製品に残します。Safest Resolve は明示的なレポートを受け、公開済みワークフローに必要な情報だけを要求します。
02
守る条件
- サーバーキーをブラウザーに置く、または未署名の参照を信頼すること。
- 必要な数項目ではなく広い記録を複製すること。
- 冪等キーなしでアクションを再試行し、結果確認前に閉じること。
03
手順
- 入口を /widget.js、/report/、/v1/reports/server から選びます。
- 最小権限のインテグレーションを作り、資格情報はバックエンドに置きます。Widget には短時間のコンテキストトークンを発行します。
- 構造化した申し立てを冪等キー付きで送信し、返されたレポート参照を保存します。
- 証拠コンポーネントに入力許可、限定スキーマ、タイムアウト、不変バージョンを定義し、署名検証後に型付き結果を返します。
- evidence_callback と action_callback に別のインテグレーションを作ります。
- ルーティング fixture と revision、ビジュアルワークフローを公開し、そのバージョンをキューに固定します。
- 成功、重複、タイムアウト、アクション再試行、メッセージ、人の claim、異議申立てをテストします。
04
運用上の境界
不透明な参照IDを使います。必須証拠の失敗は判断を止め、重要なアクションは人を待ち、呼び出しは冪等で、各コールバックは明示的な状態を記録します。
05
データ交換
Safest Resolve は安定した参照を署名付き・期限付きで送ります。自社サービスは許可された項目だけを返します。アクションは別の署名接続と安定キーを使い、コールバックが実結果を記録します。
安定した参照ID署名付きリクエスト型付きの結果
06
確認
レポートはバージョン付きキューと耐久ワークフローを通ります。製品DBを複製せず、証拠、担当者、判断、アクション、結果、メッセージ、異議申立てを確認できます。
07
導入時の質問
既存のフォームを使えますか?+
はい。構造化した出力をサーバー API に送り、外部参照を保持します。
コールバック権限はどの資格情報に与えますか?+
別々の最小権限インテグレーションを使います。evidence_callback と action_callback は submit_reports に含まれません。
Safest Resolve
チームが最初に運用するワークフローを設計しましょう。
レポートの入口、必要な証拠、判断者、製品アクション、通知、異議申立て経路から始めます。