Magic Contract

API

画面と同じ検査を、同じ経路で実行します。認証は Authorization: Bearer <トークン> です。トークンは「API キー」の画面で発行します。

メソッドとパス 中身
GET /api/v1/catalog メディア → 工程 → 固定セットと、それぞれの状態(available・preparing)
GET /api/v1/sets/{id}/{version} 固定セットの定義:入力・検査・合格条件・保証範囲
POST /api/v1/runs 実行。multipart で set・version・media と、入力ごとのファイル inputs[<入力>]
GET /api/v1/runs 自分の履歴
GET /api/v1/runs/{id} 結果
GET /api/v1/runs/{id}/package 合格済み入力の ZIP(合格したときだけ)
GET /api/v1/pass-records/{id} 合格記録
POST /api/v1/pass-records/verify 合格記録(record)と入力(inputs[<入力>])を確かめる

例:名刺の原稿を確かめる

curl -H "Authorization: Bearer $TOKEN" \
  -F set=manuscript -F version=1 -F media=business-card \
  -F "inputs[manuscript]=@card.json" \
  https://<サービス>/api/v1/runs

応答の status は passed・failed・incomplete のどれかです。準備中の固定セットや知らない入力は 422 で断ります。