PENGEMBANG · PRATINJAU API

Satu API untuk mengetahui siapa atau apa yang bertindak

Pratinjau API Proof of Actor yang diusulkan: cukup konkret untuk menunjukkan bagaimana infrastruktur ini dirancang untuk bekerja, dan diterbitkan lebih awal agar para pengembang yang akan menggunakannya dapat ikut membentuknya.

Bergabung dengan Pratinjau Pengembang

Belum siap digunakan di lingkungan produksi

Pratinjau Pengembang@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
});

Pratinjau Pengembang - desain API masih berkembang. Titik akhir, kolom, dan nama paket di halaman ini masih berupa usulan. Belum ada API produksi atau SDK yang dipublikasikan.

Antarmuka API yang diusulkan

Lima endpoint, satu atestasi

Minta bukti sesuai kebutuhan konteks Anda, periksa bukti tersebut, lalu terapkan kebijakan Anda. Model yang sama mencakup manusia, manusia yang dibantu AI, dan agen.

Buat verifikasi

POST/v1/verifications

Tentukan persyaratan interaksi: kehadiran manusia, kendali berkelanjutan, pengungkapan penggunaan AI, dan tingkat pengungkapan identitas.

API yang diusulkan

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

Ambil status aktor

GET/v1/verifications/{verification_id}

Baca jenis aktor dan tingkat keyakinan di balik setiap klaim. Kebijakan Anda menentukan tindakan selanjutnya.

API yang diusulkan

GET /v1/verifications/{verification_id}

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

Verifikasi kewenangan agen

POST/v1/authority/verify

Periksa apakah tindakan tertentu oleh agen tertentu berada dalam cakupan mandat yang diberikan oleh prinsipal yang diwakilinya.

API yang diusulkan

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
}

Minta pernyataan niat manusia secara eksplisit

POST/v1/intent

Untuk tindakan berdampak besar yang memerlukan persetujuan langsung dari manusia atas tindakan ini, pada saat ini, dalam kondisi ini.

Ambil atestasi

GET/v1/attestations/{id}

Mengembalikan Actor Trust Receipt dalam format yang dapat dibaca mesin untuk audit dan sistem hilir.

Actor Policy

Tentukan persyaratan kepercayaan Anda

Aplikasi sebaiknya dapat menyatakan persyaratannya dalam bentuk kebijakan. Prinsip arsitektur utamanya: Proof of Actor menyediakan bukti kepercayaan. Pelanggan menentukan kebijakan yang dapat diterima.

API yang diusulkanKonsep mesin kebijakan

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

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

Prinsip perancangan untuk pengembang

Integrasi seharusnya lebih mudah daripada membangun infrastruktur verifikasi internal.
Setiap hasil dapat dijelaskan: klaim disertai bukti dan tingkat keyakinan.
Minta hanya klaim yang Anda perlukan; jangan kumpulkan data lain.
Manusia dan agen sama-sama merupakan aktor utama dalam API yang sama.
Kewenangan agen selalu dapat dicabut dan selalu diperiksa untuk setiap tindakan.

Harga

Harga belum dipublikasikan selama tahap riset. Kami tidak akan menetapkannya sebelum memahami komponen dasar verifikasi mana yang paling bernilai. Salah satu kemungkinan model pada akhirnya:

Pengembang: Lingkungan uji coba gratis
Bangun: Biaya dasar bulanan + biaya berdasarkan penggunaan
Skala: Harga berdasarkan penggunaan
Perusahaan: Volume + kebijakan tingkat lanjut + penerapan privat

Pertanyaan umum

Pertanyaan dari pengembang

Apakah saya sudah bisa mengintegrasikan Proof of Actor saat ini?

Belum. Proof of Actor sedang dikembangkan dan belum ada API atau SDK untuk penggunaan produksi. Titik akses dan pemanggilan SDK di halaman ini merupakan bagian dari Developer Preview untuk rancangan yang diusulkan, yang dipublikasikan agar pengembang dapat ikut membentuknya.

Apakah akan tersedia SDK?

SDK merupakan bagian dari pengalaman pengembang yang diusulkan. Nama paket dan metode yang ditampilkan di sini hanya sebagai ilustrasi dan dapat berubah sebelum dirilis.

Bagaimana penetapan harganya?

Harga belum dipublikasikan selama tahap riset. Komponen dasar yang mungkin digunakan mencakup biaya per verifikasi, per sesi berkelanjutan, per atestasi, dan per verifikasi kewenangan, dengan lingkungan pengujian gratis bagi pengembang. Belum ada yang ditetapkan.

Bagaimana cara mendapatkan akses?

Bergabunglah dengan Pratinjau Pengembang. Beri tahu kami apa yang ingin Anda verifikasi dan perkiraan volume interaksinya; kami menggunakan jawaban tersebut untuk menentukan prioritas desain dan akses awal.

Bantu bentuk API sebelum diluncurkan.

Beri tahu kami apa yang ingin Anda verifikasi dan jumlah interaksi yang terlibat. Anggota Developer Preview dapat melihat rancangan ini lebih awal.

Bergabung dengan Pratinjau Pengembang Daftarkan kasus penggunaan agen