واجهة برمجة تطبيقات المطور
دمج شهادة blockchain والتتبع في تطبيقاتك. وثائق كاملة وأمثلة للاستخدام.
https://api.proovik.com/v1
شهادة
ختم المستندات على blockchain
/certify
تصديق مستند
يرسل تجزئة ملف ليتم تسجيلها على blockchain Kaspa. يرجع معرف المعاملة وبيانات الشهادة.
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"} }'
/verify/{hash}
تحقق من مستند
يتحقق مما إذا كانت تجزئة الملف موجودة في blockchain وترجع تفاصيل الشهادة الخاصة بها.
{
"verified": true,
"txid": "abc123...",
"timestamp": "2026-01-06T12:00:00Z",
"block_hash": "...",
"merkle_proof": [...]
}
التتبع
سلسلة الحضانة مع تسلسل التجزئة
/trace/batch
إنشاء دفعة
يخلق دفعة منتج جديد للتتبع. يرجع معرف دفعة فريد للأحداث اللاحقة.
{
"batch_id": "BATCH-2026-001",
"product": "Organic Olive Oil",
"origin": "Jaén, Spain",
"metadata": {...}
}
/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" }
}
/trace/batch/{batch_id}
احصل على سجل الدفعة
إرجاع سلسلة الأحداث الكاملة لدفعة ، مع حالة التحقق من blockchain لكل حدث.
{
"batch": {...},
"events": [
{ "type": "SOWING", "txid": "...", "verified": true },
{ "type": "HARVEST", "txid": "...", "verified": true },
{ "type": "TRANSPORT", "txid": "...", "verified": true }
],
"chain_valid": true
}
Webhooks
إخطارات في الوقت الحقيقي
تلقي إخطارات فورية عند تأكيد المعاملات على blockchain.
certification.confirmed
وثيقة مصدقة
trace.event.confirmed
تأكيد حدث التتبع
SDKs
جاهز للدمج؟
اتصل بنا للوصول إلى واجهة برمجة التطبيقات وسنساعدك على البدء.