code
REST API v1
開発者API
ブロックチェーン認証とトレーサビリティをアプリケーションに統合します。完全なドキュメントと使用例。
Base URL:
https://api.proovik.com/v1
verified
認証
ブロックチェーン上でドキュメントを封印
POST
/certify
ドキュメントを認証
Kaspaブロックチェーンに記録されるファイルハッシュを送信します。トランザクションIDと証明書データを返します。
#
リクエスト
curl -X POST https://api.proovik.com/v1/certify \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "hash": "e3b0c44298fc1c149afbf4c8996fb924...", "filename": "contract.pdf", "metadata": {"client": "Acme Corp"} }'
GET
/verify/{hash}
ドキュメントを検証
ファイルハッシュがブロックチェーン上に存在するかを確認し、その認証詳細を返します。
#
レスポンス
{
"verified": true,
"txid": "abc123...",
"timestamp": "2026-01-06T12:00:00Z",
"block_hash": "...",
"merkle_proof": [...]
}
conversion_path
トレーサビリティ
ハッシュチェーンによる管理の連鎖
POST
/trace/batch
バッチを作成
追跡する新しい製品バッチを作成します。後続のイベントのために一意のバッチIDを返します。
{
"batch_id": "BATCH-2026-001",
"product": "Organic Olive Oil",
"origin": "Jaén, Spain",
"metadata": {...}
}
POST
/trace/event
イベントを追加
バッチチェーンに新しいイベントを追加します。ハッシュチェーンを介して前のイベントに自動的にリンクします。
{
"batch_id": "BATCH-2026-001",
"event_type": "HARVEST",
"evidence_hash": "sha256:...",
"location": { "lat": 37.77, "lng": -3.79 },
"data": { "weight_kg": 500, "quality": "A" }
}
info
イベントは自動的に前のTXIDにチェーンされ、壊れないシーケンスを作成します。
GET
/trace/batch/{batch_id}
バッチ履歴を取得
バッチの完全なイベントチェーンと、各イベントのブロックチェーン検証ステータスを返します。
{
"batch": {...},
"events": [
{ "type": "SOWING", "txid": "...", "verified": true },
{ "type": "HARVEST", "txid": "...", "verified": true },
{ "type": "TRANSPORT", "txid": "...", "verified": true }
],
"chain_valid": true
}
webhook
Webhooks
リアルタイム通知
トランザクションがブロックチェーン上で確認されたときに即座に通知を受け取ります。
certification.confirmed
ドキュメント認証済み
trace.event.confirmed
トレーサビリティイベント確認済み
SDKs
🐍
Python
近日公開
🟨
JavaScript
近日公開
🐘
PHP
近日公開
🔵
Go
近日公開
統合する準備はできましたか？
APIアクセスについてはお問い合わせください。開始のお手伝いをします。