GELİŞTİRİCİLER · API ÖN İZLEMESİ

Kimin veya neyin işlem yaptığını belirlemek için tek API

Önerilen Proof of Actor API için bir önizleme: altyapının nasıl çalışmak üzere tasarlandığını gösterecek kadar somut ve onu kullanacak geliştiricilerin şekillendirebilmesi için erken yayımlanmış.

Developer Preview programına katılın

Üretim ortamında kullanıma hazır değil

Geliştirici Önizlemesi@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
});

Geliştirici Önizlemesi - API tasarımı gelişmeye devam ediyor. Bu sayfadaki uç noktalar, alanlar ve paket adları öneri niteliğindedir. Henüz üretim ortamında kullanılabilecek bir API veya yayımlanmış bir SDK bulunmuyor.

Önerilen API arayüzü

5 uç nokta, 1 attestation

Bağlamınızın gerektirdiği bilgileri talep edin, kanıtları inceleyin ve politikanızı uygulayın. Aynı model insanları, AI destekli insanları ve ajanları kapsar.

Doğrulama oluştur

POST/v1/verifications

Etkileşimin gerektirdiklerini belirtin: insanın o anda mevcut olması, kesintisiz kontrol, AI kullanımının açıklanması ve kimliğin açıklanma düzeyi.

Önerilen API

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

Aktör durumunu alın

GET/v1/verifications/{verification_id}

Aktör türünü ve her iddianın dayandığı güven düzeyini inceleyin. Bunlarla ne yapacağınıza politikanız karar verir.

Önerilen 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
}

Ajanın yetkisini doğrulayın

POST/v1/authority/verify

Belirli bir ajanın belirli bir eyleminin, adına hareket ettiği kişinin veya kuruluşun kendisine verdiği yetkinin sınırları içinde olup olmadığını sorgulayın.

Önerilen 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
}

İnsanın açık irade beyanını talep edin

POST/v1/intent

Bu eylemin, bu anda ve bu koşullar altında doğrudan insan tarafından onaylanmasını gerektiren önemli sonuçlar doğuran işlemler için.

Attestasyonu getir

GET/v1/attestations/{id}

Denetim ve sonraki aşamadaki sistemler için makine tarafından okunabilir Actor Trust Receipt kaydını döndürür.

Actor Policy

Güven gereksinimlerinizi belirtin

Uygulamalar gereksinimlerini ilke olarak tanımlayabilmelidir. Temel mimari ilke: Proof of Actor güven kanıtlarını sağlar. Hangi ilkelerin kabul edilebilir olduğuna müşteri karar verir.

Önerilen APIPolitika motoru kavramı

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

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

Geliştiriciler için tasarım ilkeleri

Entegrasyon, kurum içinde doğrulama altyapısı oluşturmaktan daha kolay olmalıdır.
Her sonuç açıklanabilir: iddialar kanıt ve güven düzeyi içerir.
Yalnızca ihtiyaç duyduğunuz doğrulanmış beyanları talep edin; daha fazlasını toplamayın.
İnsanlar ve ajanlar, aynı API içinde birinci sınıf aktörlerdir.
Temsilci yetkisi her zaman geri alınabilir ve her işlem için ayrı ayrı kontrol edilir.

Fiyatlandırma

Araştırma aşamasında fiyatlandırma yayımlanmıyor. Hangi doğrulama temel birimlerinin en fazla değeri yarattığını anlamadan fiyatlandırmayı kesinleştirmeyeceğiz. İleride uygulanabilecek olası bir model:

Geliştirici: Ücretsiz deneme ortamı
Geliştirin: Aylık sabit ücret + kullanım bedeli
Ölçek: Kullanıma dayalı fiyatlandırma
Kurumsal: Hacim + gelişmiş politika + özel dağıtım

Sık sorulan sorular

Geliştirici soruları

Proof of Actor ürününü bugün entegre edebilir miyim?

Henüz değil. Proof of Actor geliştirme aşamasındadır; kullanıma hazır bir API veya SDK yoktur. Bu sayfadaki uç noktalar ve SDK çağrıları, geliştiricilerin tasarıma yön verebilmesi için yayımlanmış önerilen tasarımın Geliştirici Önizlemesidir.

Bir SDK olacak mı?

SDK, önerilen geliştirici deneyiminin bir parçasıdır. Burada gösterilen paket adları ve yöntemler örnek niteliğindedir ve herhangi bir sürüm yayımlanmadan önce değişebilir.

Fiyatlandırma nasıl işleyecek?

Araştırma aşamasında fiyatlandırma yayımlanmıyor. Olası temel birimler arasında doğrulama başına, kesintisiz oturum başına, attestation başına ve yetki doğrulaması başına ücretlendirme ile geliştiriciler için ücretsiz bir test ortamı bulunuyor. Henüz hiçbir şey kesinleşmiş değil.

Nasıl erişim sağlayabilirim?

Developer Preview programına katılın. Neyi doğrulamaya çalıştığınızı ve yaklaşık etkileşim hacminizi bize bildirin; bu yanıtları tasarıma ve erken erişime öncelik verirken kullanıyoruz.

API kullanıma sunulmadan önce şekillenmesine katkıda bulunun.

Neyi doğrulamaya çalıştığınızı ve söz konusu etkileşimlerin hacmini bize bildirin. Developer Preview üyeleri tasarımı ilk görenler olur.

Developer Preview programına katılın Bir ajan kullanım senaryosu kaydedin