API | RunProof

まず API を試す

Free キーを使って、ブラウザから /v1/receipts と /v1/verify を試します。

Playground

receipt を確認する

API キーなしで receipt の署名検証と要点確認だけを行います。

検証ポータル

意味やテンプレートを知る

用途別テンプレート、入力の考え方、公開資料の見方を確認します。

Docs

RunProof APICurrent API endpoint and main routes

現在の API 入口： https://runproof.chamia-20260215.workers.dev

通常はこの /api/ ページから始めてください。旧導線の /api.htm は、この current page へ案内するための互換用 stub です。Start from this /api/ page. The old /api.htm path remains only as a compatibility stub that points here.

GET /health — 稼働状況の確認Service status
GET /v1/public-key — 公開鍵の取得（ローカル検証 / 検証ポータル用）Public key for offline verification and the Verify Portal
POST /v1/receipts — レシートの発行（APIキー必須）Issue receipt (API key required)
POST /v1/verify — レシートの検証（APIキー必須）Verify receipt (API key required)

キーの取得How to get an API key

Free：Free 用キー表示ページ（/free/claim/）から自動発行（Turnstile＋日次制限）。Self-serve issuance via the Free key page.
Basic / Pro：お申し込みページ → 決済後に APIキー表示ページ（/claim/）へ自動遷移し、キーを一度だけ表示。Paid plans redirect to the API key page for one-time reveal.

Basic / Pro は Stripe 決済後に APIキー表示ページ（/claim/）で one-time reveal、Free は Free 用キー表示ページ（/free/claim/）から取得します。

Freeキーを受け取るアップグレード Reference / OpenAPI

API キーの取得や Playground / Portal の利用開始により、本規約が適用されます。事前に利用規約をご確認ください。The Terms apply when you start using the service, including API key acquisition and Playground / Portal use. Please review the Terms beforehand.

検証ポータルVerify Portal

APIキーなしで receipt の署名検証と要点確認を行う公開ページです。GET /v1/receipts/{id} と GET /v1/public-key を使う public verify 前提で、receipt の自己整合と署名をブラウザ内で確認します。

このページは POST /v1/verify の置き換えではありません。元データそのものの真偽や chain link 全体は v1 では保証しません。The Verify Portal is for public verify in the browser. It does not replace POST /v1/verify or prove the original raw data itself.

個別の提供は、receipt を発行し、発行時点で運営者が案内する検証手段により確認可能な状態に置いた時点で完了します。 Verify Portal は公開確認の便宜機能であり、現時点の公開運用では、receipt ID による照会は通常 180 日程度を目安としますが、永続提供は保証しません。長期確認や独自保存が必要な場合は、利用者側でも receipt、対応するハッシュ、必要な管理情報を保管してください。

The Verify Portal is a convenience feature for public verification. Keep your receipt and related hash on your side if long-term confirmation is required.

検証ポータルを開く

用途別テンプレートSeries templates

Release / Document / Audit Pack は、同じ /v1/receipts / /v1/verify の上に置く Docs/UI レイヤです。サーバ分岐や新しい endpoint は増やしません。

receipt_kind は用途テンプレ識別と冪等性安定化のために使いますが、署名・verify ロジックの分岐条件には用いません。

Release / Document / Audit Pack の3種類のテンプレートは全プラン共通で利用できます。Free は Free の利用上限の範囲で利用します。All three Series templates are available on every plan. Free can use them within Free limits.

Release Receipt（配布物の由来証跡）
Document Receipt（文書版の存在証明）
Audit Pack Receipt（証拠束の存在証明）

最小例Quick start

公開鍵の取得：

curl -s https://runproof.chamia-20260215.workers.dev/v1/public-key

詳細は API Reference と OpenAPI を参照してください。

入力制限（重要）Input restrictions

個人情報・機密情報・秘密鍵などの送信は禁止です。入力はハッシュと非機密の補助情報（tags）に限定してください。Do NOT send PII or secrets. Send hashes plus non-sensitive tags only.

詳細：入力ポリシー（禁止事項）

レート制限Rate limits

短時間に大量のリクエストが来た場合、サービス保護のため 429 Too Many Requests を返すことがあります。その場合は時間をおいて再試行してください（Retry-After がある場合は従ってください）。

We may return 429 to protect the service. Please retry with backoff (respect Retry-After if present).

APIキーについてAPI keys

APIキーは秘密情報です。第三者に共有しないでください。
漏えいが疑われる場合、キーは失効（revoke）されます。
取得方法：Free は Free 用キー表示ページ（/free/claim/）、Basic/Pro は決済後に APIキー表示ページ（/claim/）で取得します（いずれも one-time reveal）。
例外対応：法人請求・決済/claim不具合・鍵の失効相談など、例外時のみメールでご連絡ください。