Skip to main content
Legitmark は 3 種類のイベントタイプを送信します。すべての Webhook 送信先は自動的にすべてのイベントを受信します。

state_change

サービスリクエストが新しいステータスに遷移したときに送信されます。鑑定の進捗と結果を追跡するための主要なイベントです。

Payload

フィールド

string
必須
常に "state_change" です。
string
必須
サービスリクエスト UUID。
string | null
貴社の内部商品 ID — サービスリクエスト作成時に設定した external_id。
object
必須
string
必須
ステータス変更が発生した時点の ISO 8601 タイムスタンプ。

ステータス遷移

以下の表は、処理すべき最も一般的なステータス遷移を示しています:
最も重要なステータス遷移は COMPLETE + APPROVED または COMPLETE + REJECTED です — これが最終鑑定結果です。完全なステートマシンについてはサービスリクエストのステータスをご覧ください。TypeScript SDK(v0.2.0+)を使用すると、文字列を手動で比較する代わりに isAuthentic(event) と isCounterfeit(event) でチェックできます。Webhook 処理ガイドを参照してください。

media_rejected

アップロードされた画像が品質管理に通らなかった場合に送信されます。拒否された各画像には面の UUID と拒否理由が含まれます。差し替え写真のアップロードにはこの UUID を使います。

Payload

フィールド

string
必須
常に "media_rejected" です。
string
必須
サービスリクエスト UUID。
string | null
貴社の内部商品 ID。
array
必須
拒否された画像と理由の配列。
string
必須
ISO 8601 タイムスタンプ。
media_rejected を受信したとき、サービスリクエストは QC / REJECTED です。sides の各要素について、side を面の UUID として新しい写真をアップロードしてから POST /api/v2/sr/{sr_uuid}/resubmit を呼び出します。この呼び出しで QC / PENDING に戻ります。POST /submit が使えるのは DRAFT のときだけです。QC / REJECTED から呼ぶと 400(Cannot submit: Service request is not in DRAFT state)が返ります。
TypeScript SDK を使用すると、needsResubmission(event) がこのイベントタイプに対して true を返します。Webhook 処理ガイドを参照してください。

invalidate_sr

サービスリクエストがキャンセルされた場合に送信されます。

Payload

フィールド

string
必須
常に "invalidate_sr" です。
string
必須
サービスリクエスト UUID。
string | null
貴社の内部商品 ID。
object
必須
string
必須
ISO 8601 タイムスタンプ。