Aller au contenu

DÉVELOPPEURS · API EN APERÇU

Une seule API pour savoir qui ou quoi agit

Un aperçu de la Proof of Actor API proposée : assez concret pour montrer comment l'infrastructure est conçue pour fonctionner, publié en amont afin que les développeurs qui l'utiliseront puissent contribuer à la façonner.

Rejoindre le programme Developer Preview
Pas prêt pour la production
Programme de préversion pour les développeurs@proofofactor/sdk
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
});
Programme de préversion pour les développeurs - la conception de l’API évolue. Les points de terminaison, les champs et les noms de paquets présentés sur cette page sont des propositions. Il n’existe pas encore d’API de production ni de SDK publié.

Périmètre de l’API proposée

Cinq points de terminaison, une attestation

Demandez ce dont votre contexte a besoin, examinez les preuves et appliquez votre politique. Le même modèle couvre les humains, les humains assistés par AI et les agents.

01

Créer une vérification

POST/v1/verifications

Définissez les exigences de l’interaction : présence humaine, contrôle humain continu, déclaration de l’utilisation de l’AI, niveau de divulgation de l’identité.

API proposée
POST /v1/verifications
{
  "requirements": {
    "human_presence": true,
    "continuous_control": true,
    "ai_disclosure": true
  }
}
02

Récupérer le statut de l’acteur

GET/v1/verifications/{verification_id}

Consultez le type d’acteur et le niveau de confiance associé à chaque affirmation. Votre politique détermine ensuite la marche à suivre.

API proposée
GET /v1/verifications/{verification_id}

{
  "actor_type": "human",
  "confidence": 0.97,
  "human_presence": "verified",
  "human_control": 0.94,
  "ai_participation": "low",
  "continuity": 0.99
}
03

Vérifier les pouvoirs de l'agent

POST/v1/authority/verify

Vérifier si une action précise d’un agent donné entre dans les limites du mandat que lui a confié son mandant.

API proposée
POST /v1/authority/verify
{
  "agent_id": "agt_48291",
  "requested_action": {
    "type": "purchase",
    "amount": 420,
    "currency": "USD"
  }
}

{
  "agent": "verified",
  "principal": "verified",
  "mandate": "valid",
  "action_authorised": true,
  "maximum_amount": 500
}
04

Exiger une intention humaine explicite

POST/v1/intent

Pour les actions à conséquences importantes nécessitant l’approbation directe d’un humain pour cette action, à cet instant et dans ces conditions.

05

Récupérer l’attestation

GET/v1/attestations/{id}

Renvoie l’Actor Trust Receipt lisible par machine pour les audits et les systèmes en aval.

Actor Policy

Définissez vos exigences de confiance

Les applications devraient pouvoir exprimer leurs exigences sous forme de politique. Le principe architectural essentiel : Proof of Actor fournit des éléments de preuve relatifs à la confiance. Le client définit la politique qu’il juge acceptable.

API proposéeConcept de moteur de règles
policy.require({
  actor: "human",
  presence: "continuous",
  control: 0.90,
  aiAssistance: "low"
});

policy.allow({
  actor: ["human", "authorized_agent"],
  agentAuthority: {
    required: true
  }
});

Principes de conception pour les développeurs

  • L’intégration devrait être plus simple que la création d’une infrastructure interne de vérification.
  • Chaque résultat peut être expliqué : les affirmations sont accompagnées de preuves et d'un niveau de confiance.
  • Ne demandez que les assertions dont vous avez besoin ; ne recueillez rien de plus.
  • Les humains et les agents sont des acteurs à part entière au sein de la même API.
  • L'autorité d'un agent est toujours révocable et vérifiée pour chaque action.

Tarifs

Les tarifs ne sont pas publiés pendant la phase de recherche. Nous ne fixerons pas le modèle avant de savoir quelles fonctions élémentaires de vérification apportent le plus de valeur. Voici un modèle qui pourrait être adopté à terme :

Développeur
Environnement de test gratuit
Développer
Forfait mensuel + utilisation
Échelle
Tarification à l’usage
Entreprises
Volume + politique avancée + déploiement privé

Questions fréquentes

Questions des développeurs

Puis-je intégrer Proof of Actor dès aujourd'hui ?

Pas encore. Proof of Actor est en cours de développement et ne dispose ni d'une API ni d'un SDK de production. Les points de terminaison et les appels SDK présentés sur cette page donnent un aperçu, dans le cadre du programme Developer Preview, de la conception proposée afin que les développeurs puissent contribuer à la définir.

Un SDK sera-t-il disponible ?

Un SDK fait partie de l’expérience développeur proposée. Les noms des paquets et les méthodes présentés ici sont donnés à titre d’exemple et peuvent changer avant toute publication.

Comment la tarification fonctionnera-t-elle ?

Les tarifs ne sont pas publiés pendant la phase de recherche. Les unités de facturation envisagées comprennent chaque vérification, chaque session continue, chaque attestation et chaque vérification d'autorité, avec un environnement de test gratuit pour les développeurs. Rien n'est fixé.

Comment obtenir un accès ?

Rejoignez le programme Developer Preview. Indiquez-nous ce que vous cherchez à vérifier et le volume approximatif d'interactions ; nous utilisons ces réponses pour définir les priorités de conception et d'accès anticipé.

Contribuez à définir l'API avant son lancement.

Dites-nous ce que vous cherchez à vérifier et le volume d’interactions concerné. Les membres du programme Developer Preview découvrent la conception en premier.