SVILUPPATORI · ANTEPRIMA API

Una sola API per sapere chi o cosa sta agendo

Un'anteprima della API proposta di Proof of Actor: abbastanza concreta da mostrare come l'infrastruttura è progettata per funzionare, pubblicata in anticipo affinché gli sviluppatori che la useranno possano contribuire a definirla.

Partecipa al programma Developer Preview

Non pronto per l'uso in produzione

Anteprima per sviluppatori@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
});

Anteprima per sviluppatori - la progettazione dell'API è in evoluzione. Gli endpoint, i campi e i nomi dei pacchetti in questa pagina sono proposte. Non sono ancora disponibili un'API di produzione né un SDK pubblicato.

Interfaccia dell'API proposta

Cinque endpoint, un'attestazione

Richiedi ciò che serve nel tuo contesto, esamina le evidenze e applica le tue regole. Lo stesso modello copre esseri umani, esseri umani assistiti dall'AI e agenti.

Crea una verifica

POST/v1/verifications

Specifica cosa richiede l'interazione: presenza umana, controllo continuo, dichiarazione dell'uso dell'AI, livello di identificazione.

API proposta

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

Recupera lo stato dell'attore

GET/v1/verifications/{verification_id}

Esamina il tipo di attore e il grado di confidenza di ogni affermazione. La tua policy stabilisce come usarli.

API proposta

GET /v1/verifications/{verification_id}

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

Verifica i poteri dell'agente

POST/v1/authority/verify

Verificare se una specifica azione compiuta da un determinato agente rientra nel mandato conferito dal suo mandante.

API proposta

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
}

Richiedi una manifestazione esplicita della volontà umana

POST/v1/intent

Per le azioni rilevanti che richiedono l'approvazione diretta di una persona per questa specifica azione, in questo momento e a queste condizioni.

Recupera l'attestazione

GET/v1/attestations/{id}

Restituisce l'Actor Trust Receipt leggibile dalle macchine per le verifiche e i sistemi a valle.

Actor Policy

Definisci i tuoi requisiti di fiducia

Le applicazioni dovrebbero poter definire i propri requisiti sotto forma di policy. Il principio architetturale fondamentale: Proof of Actor fornisce evidenze per valutare l'affidabilità. Il cliente stabilisce le policy da applicare.

API propostaSchema concettuale del motore delle regole

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

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

Principi di progettazione per sviluppatori

L'integrazione dovrebbe essere più semplice della creazione di un'infrastruttura interna di verifica.
Ogni risultato è spiegabile: le affermazioni sono accompagnate da evidenze e da un livello di confidenza.
Richiedi solo le attestazioni necessarie; non raccogliere altro.
Umani e agenti sono entrambi attori di primo piano nella stessa API.
L'autorità dell'agente è sempre revocabile e viene sempre verificata per ogni azione.

Prezzi

I prezzi non vengono pubblicati durante la fase di ricerca. Non definiremo il modello prima di capire quali tipi di verifica creano più valore. Un possibile modello futuro:

Sviluppatore: Ambiente di test gratuito
Sviluppa: Quota mensile di base + consumo
Scalabilità: Tariffe in base all'utilizzo
Aziende: Volume + regole avanzate + distribuzione privata

Domande frequenti

Domande degli sviluppatori

Posso integrare Proof of Actor già oggi?

Non ancora. Proof of Actor è in fase di sviluppo e non sono disponibili API o SDK per l'uso in produzione. Gli endpoint e le chiamate SDK in questa pagina fanno parte della Developer Preview del progetto proposto, pubblicata per consentire agli sviluppatori di contribuire a definirlo.

Sarà disponibile un SDK?

Un SDK fa parte dell'esperienza proposta per gli sviluppatori. I nomi dei pacchetti e i metodi mostrati qui sono indicativi e potrebbero cambiare prima di qualsiasi rilascio.

Come funzioneranno i prezzi?

I prezzi non vengono pubblicati durante la fase di ricerca. Le unità di tariffazione previste potrebbero includere la singola verifica, la sessione continua, la singola attestazione e la verifica dell'autorità, con un ambiente di test gratuito per gli sviluppatori. Nulla è ancora definito.

Come posso ottenere l'accesso?

Partecipa al programma Developer Preview. Dicci che cosa vuoi verificare e il volume indicativo delle interazioni; useremo queste risposte per definire le priorità di progettazione e di accesso anticipato.

Contribuisci a definire l'API prima del rilascio.

Dicci che cosa stai cercando di verificare e quanti interazioni sono coinvolte. I membri del programma Developer Preview possono esaminare il progetto in anteprima.

Partecipa al programma Developer Preview Registra un caso d'uso per agenti