Ana içeriğe atla
APIS

API'nizi kimin çağırdığını anlayın.

Her API isteğine aktör bağlamı ekleyin: hangi istemci çağırıyor, kanıt ne kadar güçlü ve API'nizin buna yol bazında ne yapması gerektiği.

Erken erişim alınNasıl çalıştığını keşfet
example-app.test · aktör sonucu

POST /api/v1/orders

Ajanbasis: inferred

Kanıt

Tarayıcı bağlamı olmayan ve otomatik bir istek kalıbı gösteren API anahtarı trafiği

Politikanız: Siparişi oluşturmadan önce daha güçlü kimlik doğrulamayı iste

Bir API anahtarı kimlik değildir ve kimlik izin değildir.

API trafiğinin çoğu, hangi müşterinin çağrı yaptığını veya kimin yönlendirdiğini değil, hangi hesabın ödeme yaptığını söyleyen bir kimlikle gelir. Bazı müşteriler isteklerini imzalar, çoğu yalnızca bir ad beyan eder ve birçoğu hiçbir şey söylemez.

Proof of Actor, her API'nin yanıtlaması gereken üç soruyu ayırır, böylece her biri doğru kanıta ve doğru kontrole sahip olur.

üç ayrı soru
  • Kim çağırıyor?Aktör kimliği: imza, beyan veya çıkarım
  • Hangi kimlik bilgisi?API anahtarınız, OAuth token'ınız veya oturumunuz
  • Neler yapabilir?Yetkilendirmeniz ve politikanız

Proof of Actor ilk soruyu yanıtlar. Sizin yığınınız diğer ikisini korur.

API ekipleri aktör bağlamıyla ne yapar

  • İmzalı istemcileri tanıyın

    İstek imzalarını yayımlanmış anahtarlarla karşılaştırın ve bir isteğin hangi operatöre ait olduğunu görün.

  • Beyanları beyan olarak ele alın

    Kendini beyan eden client adlarını kaydedin ve bunları doğrulanmış kimlikten ayrı tutun.

  • Route başına politikalar

    Düşük etkili okumalara serbestçe izin verin ve yazma işlemleri ile yüksek etkili endpoint'lerde daha fazlasını isteyin.

  • Tüm çağıranları görün

    Belirsiz olanlar dahil, hangi istemcilerin hangi endpoint'leri kullandığını anlayın.

  • Kimlik bilgilerini ayrı tutun

    Erişimi hâlâ API keys ve OAuth belirler. Aktör bağlamı, kimin çağrı yaptığını ekler.

  • Unknown için planla

    Her rota için, çağıran geçerli kanıt sağlamadığında ne olacağını tanımlayın.

01 · Tespit

Her isteğin kanıtı.

Sunucu, edge ve HTTP API entegrasyonları istek imzalarını, beyan edilen istemci ayrıntılarını ve istek bağlamını okur ve her birini dayanağıyla etiketler.

  • HTTP message signatures, yayımlanmış anahtarlara karşı doğrulanır.
  • Beyan olarak kaydedilen beyan edilen istemci adları.
  • Sunucunuzdan, ağ geçidinizden veya edge'inizden istek bağlamını alın.
sinyaller · kaynak başına son istek
  • İstek imzasıvalid · sample-crawler.exampleverified
  • İstemci beyanı"research-assistant/2.1"declared
  • Tarayıcı etkileşimipointer + keyboard eventsinferred
  • Desteklenen sinyal yokroute not instrumentedunknown

02 · Anla

Hangi endpoint'i kimin kullandığını bilin.

Her rotadaki aktör dağılımını, hangi operatörlerin sizi en çok aradığını ve bilinmeyen çağrıların nerede yoğunlaştığını görün.

  • Yola ve operatöre göre çağıranlar.
  • Her sınıflandırmanın arkasındaki kanıt.
  • Endpoint başına Unknown oranı.
route'a göre traffic · 7 days
  • /dashboardBilinmiyor 7%
  • /api/v1/catalogBilinmiyor 15%
  • /support/ticketsBilinmiyor 8%
  • /signupBilinmiyor 21%
İnsanİnsan + Yapay ZekaAjanBilinmiyor

03 · Yönlendir

Etkisiyle uyumlu kontroller.

Rota düzeyinde politikalar yazın: Verified ajanlar için yapılandırılmış yanıtlar, Declared istemciler için standart sınırlar, yüksek etkili işlemler için daha güçlü kimlik bilgileri.

  • Route, class ve basis'e göre politikalar.
  • Önemli olduğunda daha güçlü kimlik bilgilerine geçin.
  • Gözlemle, önizle, sonra uygula.
policy · example-app.test
  • /api/v1/catalogenforceAjanİzin ver · yapılandırılmış API
  • /support/ticketsenforceİnsan + Yapay Zekaİzin ver · AI destekli olarak etiketle
  • /account/*previewBilinmiyorMevcut kontrolleri koruyun
  • /api/v1/orderspreviewAjanDaha güçlü kimlik bilgisi isteyin

Örnek kararlar

İstekten sonuca, ardından sizin kararınıza.

  • Doğrulanmış bir Agent kataloğunuzu okur

    İstek

    GET /api/v1/catalog

    Sonuç

    Ajanbasis: verified

    Kararınız

    Ajan rate limit'i ve yapılandırılmış yanıt ile izin verin.

  • Otomatik bir istemci sipariş verir

    İstek

    POST /api/v1/orders

    Sonuç

    Ajanbasis: inferred

    Kararınız

    Siparişi oluşturmadan önce uygulamanın daha güçlü kimlik doğrulamasını isteyin.

  • Kanıtı olmayan bir istemci

    İstek

    GET /api/v1/catalog

    Sonuç

    Bilinmiyorbasis: unknown

    Kararınız

    Salt okunur route: varsayılan rate limit ile allow et.

Risksiz devreye alın

Ekipler gözlem modunda başlar ve route route ilerler.

  1. 01

    Her route'u gözlemleyin

    API'nizin önüne ara katman yazılımını veya HTTP API'yi ekleyin. İmzalar, beyanlar ve Unknown çağrılar her route için kaydedilir.

  2. 02

    Route politikalarını önizleyin

    Agent rate limitlerinin veya step-up kimlik bilgilerinin gerçek trafikte, uygulanmadan önce ne yapacağını kontrol edin.

  3. 03

    Etkisine göre uygulayın

    Okuma işlemlerini açık tutun, yazma işlemlerini sıkılaştırın ve erişim üzerinde denetimi API anahtarları ve OAuth'ta bırakın.

Stack'inizle çalışır

  • Kurucu ekipler

    Web sunucusu ara katmanı (Node.js)

    Sunucu tarafı

    Sunucu tarafında oluşturulan uygulamalar ve API'ler için istek düzeyi sinyaller.

  • Kurucu ekipler

    Next.js

    Sunucu tarafı ve edge

    Sayfa ve API route'ları için middleware.

  • Kurucu ekipler

    Tarayıcı betiği

    Yalnızca tarayıcı sinyalleri

    Sunucu tarafı bir entegrasyonla birlikte tarayıcı oturumlarından gelen etkileşim sinyalleri.

  • Kurucu ekipler

    Cloudflare ve edge çalışma zamanları

    Edge

    İstekler origin'e ulaşmadan önce edge'deki sinyaller.

  • Kurucu ekipler

    Genel HTTP API

    Herhangi bir stack

    İstek bağlamını bir API'ye gönderin ve dayanağıyla birlikte bir sonuç alın.

  • Kurucu ekipler

    MCP sunucusu

    MCP

    MCP araç çağrıları için aktör bağlamı.

  • Yol haritası

    WordPress

    Eklenti

    WordPress siteleri için eklenti.

  • Yol haritası

    Native mobil

    iOS ve Android

    Native iOS ve Android SDK'lar.

Entegrasyonlar, onboarding sırasında her kurucu ekiple uygulamalı olarak teslim edilir. Farklı bir yığın mı kullanıyorsunuz? Başvuru yaparken bize bildirin.

Daha fazla bilgi edinin

Detection & Limitations sayfasını okuyun

Sık sorulan sorular

İstemcilerin isteklerini imzalaması gerekir mi?

Hayır. İmzalı istekler en güçlü kanıtı sağlar, ancak Proof of Actor beyanları ve çıkarımları da kaydeder, her birini dayanağıyla etiketler ve yeterli olmadığında Unknown olarak raporlar.

Geçerli bir imza, istemcinin hareket etmesine izin verildiği anlamına mı gelir?

Hayır. İsteğin, yayınlanmış bir tanımlayıcıya bağlı bir anahtarla imzalandığını gösterir. O operatörün ne yapabileceğine yetkilendirme ve politikanız karar verir.

API anahtarlarının veya OAuth'un yerini alır mı?

Hayır. Erişimi hala kimlik bilgileri kontrol eder. Proof of Actor, kimin veya neyin çağırdığını ekler, böylece bunun üzerine daha iyi politikalar uygulayabilirsiniz.

Her endpoint için farklı kurallar belirleyebilir miyiz?

Evet. Politikalar rota bazında yazılır, bu nedenle salt okunur endpoint'ler ve yüksek etkili yazma işlemleri farklı şekilde ele alınabilir.

Maliyeti nedir?

Seçilmiş kurucu geliştirici ekipler, üzerinde anlaşılan kullanım sınırları dahilinde 12 aya kadar ücretsiz kullanım alabilir.

API'nizi kimin çağırdığını bilin.

Proof of Actor founding developer program'a katılın.

Erken erişim alınGeliştirici merkezi

Önce konuşmak mı istersiniz? Kurucularla konuşun