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
곧 출시