ONTWIKKELAARS · API-PREVIEW

Eén API om vast te stellen wie of wat handelt

Een preview van de voorgestelde Proof of Actor API: concreet genoeg om te laten zien hoe de infrastructuur is ontworpen om te werken, en vroeg gepubliceerd zodat de ontwikkelaars die de infrastructuur gaan gebruiken, deze mede vorm kunnen geven.

Meld u aan voor Developer Preview

Niet klaar voor productie

Developer Preview@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
});

Developer Preview - Het ontwerp van de API is nog in ontwikkeling. De endpoints, velden en pakketnamen op deze pagina zijn voorstellen. Er is nog geen productie-API of gepubliceerde SDK.

Voorgestelde API-interface

Vijf eindpunten, één attestatie

Vraag op wat uw context vereist, beoordeel het bewijsmateriaal en pas uw beleid toe. Hetzelfde model geldt voor mensen, mensen met AI-ondersteuning en agenten.

Verificatie aanmaken

POST/v1/verifications

Geef aan wat de interactie vereist: menselijke aanwezigheid, voortdurende controle door een mens, melding van AI-gebruik en het niveau van identiteitsgegevens dat moet worden verstrekt.

Voorgestelde API

POST /v1/verifications
{
  "requirements": {
    "human_presence": true,
    "continuous_control": true,
    "ai_disclosure": true
  }
}

Actor-status ophalen

GET/v1/verifications/{verification_id}

Bekijk het actortype en de mate van vertrouwen achter elke bewering. Uw beleid bepaalt wat u daarmee doet.

Voorgestelde API

GET /v1/verifications/{verification_id}

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

Verifieer de bevoegdheid van de agent

POST/v1/authority/verify

Controleer of een specifieke handeling van een specifieke agent binnen de bevoegdheid valt die de principaal aan die agent heeft verleend.

Voorgestelde API

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
}

Vraag om expliciete menselijke intentie

POST/v1/intent

Voor handelingen met verstrekkende gevolgen waarvoor directe menselijke goedkeuring nodig is voor deze handeling, op dit moment en onder deze voorwaarden.

Attestatie ophalen

GET/v1/attestations/{id}

Geeft de machineleesbare Actor Trust Receipt terug voor audits en systemen die de gegevens verder verwerken.

Actor Policy

Geef je vertrouwensvereisten op

Applicaties zouden hun vereisten als beleid moeten kunnen vastleggen. Het belangrijkste architectuurprincipe: Proof of Actor levert bewijs voor vertrouwen. De klant bepaalt welk beleid aanvaardbaar is.

Voorgestelde APIConcept voor een beleidsengine

policy.require({
  actor: "human",
  presence: "continuous",
  control: 0.90,
  aiAssistance: "low"
});

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

Ontwerpprincipes voor ontwikkelaars

Integratie zou eenvoudiger moeten zijn dan het bouwen van een eigen infrastructuur voor verificatie.
Elk resultaat is uitlegbaar: uitspraken bevatten bewijs en een betrouwbaarheidsniveau.
Vraag alleen de verklaringen op die u nodig hebt; verzamel verder niets.
Mensen en agenten zijn gelijkwaardige actoren binnen dezelfde API.
De bevoegdheid van een agent kan altijd worden ingetrokken en wordt voor elke handeling gecontroleerd.

Prijzen

Tijdens de onderzoeksfase worden geen prijzen gepubliceerd. We leggen het prijsmodel pas vast als we begrijpen welke verificatiebouwstenen de meeste waarde opleveren. Een mogelijk toekomstig model:

Ontwikkelaar: Gratis testomgeving
Bouwen: Maandelijks basisbedrag + gebruik
Schaal: Tarieven op basis van gebruik
Voor ondernemingen: Volume + geavanceerd beleid + private implementatie

Veelgestelde vragen

Vragen van ontwikkelaars

Kan ik Proof of Actor nu al integreren?

Nog niet. Proof of Actor is in ontwikkeling en er is geen productieklare API of SDK. De eindpunten en SDK-aanroepen op deze pagina zijn een Developer Preview van het voorgestelde ontwerp, gepubliceerd zodat ontwikkelaars eraan kunnen bijdragen.

Komt er een SDK?

Een SDK maakt deel uit van de voorgestelde ontwikkelaarservaring. De hier getoonde pakketnamen en methoden zijn illustratief en kunnen vóór een eventuele release veranderen.

Hoe gaat de prijsstelling werken?

Tijdens de onderzoeksfase worden geen prijzen gepubliceerd. Mogelijke afrekeneenheden zijn per verificatie, per doorlopende sessie, per attestatie en per verificatie van bevoegdheid, met een gratis testomgeving voor ontwikkelaars. Niets ligt vast.

Hoe krijg ik toegang?

Meld u aan voor het Developer Preview-programma. Vertel ons wat u wilt verifiëren en hoeveel interacties u ongeveer verwacht; we gebruiken die antwoorden om prioriteiten te stellen voor het ontwerp en de vroege toegang.

Geef de API vorm voordat die beschikbaar komt.

Vertel ons wat u wilt verifiëren en om hoeveel interacties het gaat. Deelnemers aan de Developer Preview krijgen het ontwerp als eerste te zien.

Meld u aan voor Developer Preview Registreer een toepassing voor een AI-agent