import { ProofOfActor } from "@proofofactor/sdk";
const actor = await ProofOfActor.verify({
require: [
"human_presence",
"human_control",
"session_continuity"
]
});
if (actor.humanControl > 0.90) {
allow();
}
// For agents
const authority = await ProofOfActor.verifyAuthority({
agent,
action
});نطاق واجهة API المقترحة
خمس نقاط نهاية، وإفادة مصدّقة واحدة
اطلب ما يقتضيه سياقك، واطّلع على الأدلة، وطبّق سياستك. يشمل النموذج نفسه البشر، والبشر الذين يستعينون بـ AI، والوكلاء.
إنشاء عملية تحقق
POST/v1/verifications
حدّد ما يتطلبه التفاعل: حضور الإنسان، واستمرار تحكمه، والإفصاح عن استخدام AI، ومستوى الإفصاح عن الهوية.
POST /v1/verifications
{
"requirements": {
"human_presence": true,
"continuous_control": true,
"ai_disclosure": true
}
}استرجاع حالة الفاعل
GET/v1/verifications/{verification_id}
اطّلع على نوع الجهة الفاعلة ودرجة الثقة التي يستند إليها كل ادعاء. وتحدد سياستك كيفية التعامل مع هذه المعلومات.
GET /v1/verifications/{verification_id}
{
"actor_type": "human",
"confidence": 0.97,
"human_presence": "verified",
"human_control": 0.94,
"ai_participation": "low",
"continuity": 0.99
}طلب تأكيد صريح للنية البشرية
POST/v1/intent
للإجراءات ذات التبعات التي تتطلب موافقة بشرية مباشرة على هذا الإجراء، في هذا الوقت، ووفق هذه الشروط.
استرجاع الإقرار
GET/v1/attestations/{id}
يعيد Actor Trust Receipt بصيغة قابلة للقراءة آليًا لأغراض التدقيق والأنظمة اللاحقة.
Actor Policy
حدّد متطلبات الثقة لديك
ينبغي أن تتمكن التطبيقات من تحديد متطلباتها في صورة سياسة. والمبدأ المعماري الأساسي هو أن Proof of Actor توفّر أدلة الثقة، بينما يحدّد العميل السياسة المقبولة.
policy.require({
actor: "human",
presence: "continuous",
control: 0.90,
aiAssistance: "low"
});
policy.allow({
actor: ["human", "authorized_agent"],
agentAuthority: {
required: true
}
});مبادئ التصميم للمطورين
- ينبغي أن يكون التكامل أسهل من بناء بنية تحتية داخلية للتحقق.
- يمكن تفسير كل نتيجة: فالادعاءات مصحوبة بأدلة ودرجات ثقة.
- اطلب فقط ما تحتاج إليه من إفادات؛ ولا تجمع أكثر من ذلك.
- البشر والوكلاء جهات فاعلة أساسية على قدم المساواة ضمن API نفسها.
- يمكن دائمًا إلغاء صلاحيات الوكيل، ويُتحقَّق منها عند كل إجراء.
التسعير
لا تُنشر الأسعار خلال مرحلة البحث. لن نعتمد نموذجاً نهائياً قبل أن نفهم أي عمليات التحقق الأساسية تحقق أكبر قيمة. ومن النماذج المحتملة مستقبلاً:
- المطوّر
- بيئة اختبار مجانية
- البناء
- رسوم أساسية شهرية + رسوم حسب الاستخدام
- التوسع
- التسعير حسب الاستخدام
- المؤسسات
- حجم الاستخدام + سياسات متقدمة + نشر خاص
الأسئلة الشائعة
أسئلة المطوّرين
هل يمكنني دمج Proof of Actor اليوم؟
ليس بعد. لا يزال Proof of Actor قيد التطوير، ولا تتوفر API أو SDK للاستخدام الفعلي. نقاط النهاية واستدعاءات SDK في هذه الصفحة معاينة للمطورين للتصميم المقترح، منشورة لتمكين المطورين من المساهمة في صياغته.
هل ستتوفر حزمة SDK؟
تُعدّ SDK جزءًا من تجربة المطوّرين المقترحة. أسماء الحزم والطرق المعروضة هنا أمثلة توضيحية وقد تتغير قبل أي إصدار.
كيف سيُحدَّد التسعير؟
لا تُنشر الأسعار خلال مرحلة البحث. من المرجح أن تشمل وحدات التسعير الأساسية رسوماً لكل عملية تحقق، ولكل جلسة مستمرة، ولكل إفادة موثّقة، ولكل عملية تحقق من الصلاحية، مع بيئة تجريبية مجانية للمطورين. لم يُحسم شيء بعد.
كيف يمكنني الحصول على حق الوصول؟
انضم إلى برنامج المعاينة للمطورين. أخبرنا بما تحاول التحقق منه وبالحجم التقريبي للتفاعلات؛ نستخدم هذه الإجابات لتحديد أولويات التصميم والإتاحة المبكرة.
ساهم في تشكيل API قبل إطلاقها.
أخبرنا بما تحاول التحقق منه وحجم التفاعلات المعنية. يطّلع أعضاء برنامج المعاينة للمطورين على التصميم أولاً.