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
});Superficie de la API propuesta
Cinco puntos de acceso, una atestación
Solicite lo que necesite en su contexto, examine las pruebas y aplique su política. El mismo modelo abarca a humanos, humanos asistidos por AI y agentes.
Crear verificación
POST/v1/verifications
Indica qué requiere la interacción: presencia humana, control continuo, declaración del uso de AI y nivel de información sobre la identidad.
POST /v1/verifications
{
"requirements": {
"human_presence": true,
"continuous_control": true,
"ai_disclosure": true
}
}Consultar el estado del actor
GET/v1/verifications/{verification_id}
Consulta el tipo de actor y el grado de confianza de cada afirmación. Tu política determina qué hacer con esa información.
GET /v1/verifications/{verification_id}
{
"actor_type": "human",
"confidence": 0.97,
"human_presence": "verified",
"human_control": 0.94,
"ai_participation": "low",
"continuity": 0.99
}Solicitar una intención humana explícita
POST/v1/intent
Para acciones de gran trascendencia que requieren la aprobación directa de una persona para esta acción, en este momento y bajo estas condiciones.
Recuperar la atestación
GET/v1/attestations/{id}
Devuelve el Actor Trust Receipt en un formato legible por máquina para auditorías y sistemas posteriores.
Actor Policy
Define tus requisitos de confianza
Las aplicaciones deberían poder declarar sus requisitos como una política. El principio arquitectónico clave: Proof of Actor proporciona evidencias de confianza. El cliente determina la política aceptable.
policy.require({
actor: "human",
presence: "continuous",
control: 0.90,
aiAssistance: "low"
});
policy.allow({
actor: ["human", "authorized_agent"],
agentAuthority: {
required: true
}
});Principios de diseño para desarrolladores
- La integración debería ser más sencilla que desarrollar una infraestructura interna de verificación.
- Cada resultado puede explicarse: las afirmaciones incluyen pruebas y niveles de confianza.
- Solicite solo las declaraciones que necesite; no recopile nada más.
- Los humanos y los agentes son actores de pleno derecho en la misma API.
- La autoridad del agente siempre puede revocarse y se comprueba para cada acción.
Precios
Los precios no se publican durante la fase de investigación. No definiremos el modelo hasta entender qué tipos de verificación aportan más valor. Un posible modelo futuro:
- Desarrollador
- Entorno de pruebas gratuito
- Desarrollar
- Cuota base mensual + uso
- Escala
- Precios según el uso
- Empresas
- Volumen + políticas avanzadas + despliegue privado
Preguntas frecuentes
Preguntas para desarrolladores
¿Puedo integrar Proof of Actor hoy?
Todavía no. Proof of Actor está en desarrollo y no hay ninguna API ni ningún SDK de producción. Los puntos de acceso y las llamadas al SDK de esta página forman parte de una vista previa para desarrolladores del diseño propuesto, publicada para que los desarrolladores contribuyan a darle forma.
¿Habrá un SDK?
Un SDK forma parte de la experiencia propuesta para desarrolladores. Los nombres de paquetes y métodos que se muestran aquí son ilustrativos y pueden cambiar antes de cualquier lanzamiento.
¿Cómo funcionarán los precios?
Los precios no se publican durante la fase de investigación. Entre las posibles unidades de facturación se incluyen cada verificación, cada sesión continua, cada atestación y cada verificación de autoridad, con un entorno de pruebas gratuito para desarrolladores. Nada está definido.
¿Cómo puedo obtener acceso?
Únete al programa de vista previa para desarrolladores. Cuéntanos qué intentas verificar y el volumen aproximado de interacciones; usamos esas respuestas para priorizar el diseño y el acceso anticipado.
Ayuda a definir la API antes de su lanzamiento.
Cuéntenos qué intenta verificar y cuántas interacciones hay implicadas. Los participantes en Developer Preview conocen el diseño antes que nadie.