Legitmark API Platform Documentation

概要

サービスリクエストは 2 部構成の状態システムを使用します：

主要状態：メインステージ（DRAFT → QC → UNDERWAY → COMPLETE）
補足状態：追加コンテキスト（PENDING、APPROVED、REJECTED など）

状態の組み合わせ

主要状態	補足状態	説明	パートナーアクション
`DRAFT`	-	作成直後、要件が不足	支払い/画像を完了
`QC`	`PENDING`	品質管理レビュー待ち	レビューを待機
`QC`	`REJECTED`	写真が品質審査に不合格	拒否された面を再アップロードし、`POST /resubmit`
`QC`	`APPROVED`	品質管理合格	認証を待機
`QC`	`COMPLETE`	QC 中のファストトラック完了	最終結果を確認
`UNDERWAY`	`PENDING`	認証割り当て準備完了	割り当てを待機
`UNDERWAY`	`ASSIGNED`	認証者が割り当てられ作業中	完了を待機
`UNDERWAY`	`APPROVED`	認証プロセス完了	最終結果を待機
`COMPLETE`	`APPROVED`	本物 - アイテムが本物と確認	認証合格
`COMPLETE`	`REJECTED`	偽物 - アイテムは偽造品	認証不合格
`COMPLETE`	`COMPLETE`	ドキュメント付きで完全処理済み	認証完了
`CANCELLED`	-	サービスリクエストがキャンセル	リクエストキャンセル

ワークフロー

処理が必要な主要状態

状態	必要なアクション
`QC + REJECTED`	拒否された写真を再アップロードし、`POST /api/v2/sr/{uuid}/resubmit` を呼ぶ
`COMPLETE + APPROVED`	認証合格 - アイテムが本物と確認
`COMPLETE + REJECTED`	認証不合格 - アイテムは本物ではない
`CANCELLED`	リクエストキャンセル - サービスリクエストがキャンセルされた

実装

// 基本的な状態処理
function handleServiceRequestUpdate(sr) {
  if (sr.state.primary === 'QC' && sr.state.supplement === 'REJECTED') {
    showAttentionRequired(sr); // パートナーアクションが必要
  }
  
  if (sr.state.primary === 'COMPLETE') {
    if (sr.state.supplement === 'APPROVED') {
      handleAuthentic(sr); // 認証合格
    } else {
      handleNotAuthentic(sr); // 認証不合格
    }
  }
}

写真の再提出

QC / REJECTED は、品質管理が新しい写真を求めた状態です。拒否された各面の写真を再アップロードしてから POST /api/v2/sr/{sr_uuid}/resubmit を呼び出します。成功すると QC / PENDING に戻ります。 POST /api/v2/sr/{sr_uuid}/submit は DRAFT のときに使います。QC / REJECTED から呼ぶと 400 が返ります。

Webhook

Webhook を通じてリアルタイム更新が利用可能：

state_change - 任意の状態遷移
media_rejected - 画像の修正が必要
invalidate_sr - リクエストがキャンセル

完全な詳細は Webhook イベントをご覧ください。

​概要

​状態の組み合わせ

​ワークフロー

​処理が必要な主要状態

​実装

​写真の再提出

​Webhook

概要

状態の組み合わせ

ワークフロー

処理が必要な主要状態

実装

写真の再提出

Webhook