ప్రధాన కంటెంట్‌కు దాటవేయండి
APIS

మీ API ను ఎవరు call చేస్తున్నారో అర్థం చేసుకోండి.

ప్రతి API request కు actor context ను జోడించండి: ఏ client పిలుస్తోంది, evidence ఎంత బలంగా ఉంది, మరియు మీ API దాని గురించి ఏమి చేయాలి, రూట్ వారీగా.

తొందరగా యాక్సెస్ పొందండిఇది ఎలా పనిచేస్తుందో అన్వేషించండి
example-app.test · actor result

POST /api/v1/orders

ఏజెంట్basis: inferred

సాక్ష్యం

browser context లేకుండా, automated request pattern తో ఉన్న API-key traffic

మీ policy: order సృష్టించే ముందు మరింత బలమైన credential అడగండి

API key అనేది identity కాదు, మరియు identity అనేది permission కాదు.

చాలా API traffic ఒక credential తో వస్తుంది, అది ఏ account చెల్లిస్తోంది అనేది చెబుతుంది, కానీ ఏ client call చేస్తోంది లేదా ఎవరు దాన్ని సూచించారు అనేది కాదు. కొన్ని clients తమ requests ను sign చేస్తాయి, చాలావి కేవలం ఒక పేరు declare చేస్తాయి, మరెన్నో ఏమీ చెప్పవు.

ప్రతి API సమాధానం ఇవ్వాల్సిన మూడు ప్రశ్నలను Proof of Actor వేరు చేస్తుంది, అందువల్ల ప్రతి దానికి సరైన evidence మరియు సరైన control లభిస్తుంది.

మూడు వేర్వేరు ప్రశ్నలు
  • ఎవరు పిలుస్తున్నారు?Actor గుర్తింపు: సంతకం, ప్రకటన లేదా అనుమానం
  • ఏ credential?మీ API key, OAuth token లేదా session
  • అది ఏమి చేయవచ్చు?మీ authorization మరియు policy

Proof of Actor మొదటి ప్రశ్నకు సమాధానం ఇస్తుంది. మిగతా రెండింటిని మీ stack ఉంచుకుంటుంది.

API teams actor context తో ఏమి చేస్తాయి

  • సంతకం చేసిన clients ను గుర్తించండి

    ప్రచురించిన కీలకు వ్యతిరేకంగా request signatures ను తనిఖీ చేసి, ఒక request ఏ operator కు చెందిందో చూడండి.

  • declarations ను declarations గానే పరిగణించండి

    స్వయంగా ప్రకటించిన client పేర్లను నమోదు చేసి, వాటిని verified identity నుండి వేరుగా ఉంచండి.

  • ప్రతి రూట్ కు policies

    low-impact reads ను స్వేచ్ఛగా అనుమతించండి, మరియు writes మరియు high-impact endpoints పై మరింత అడగండి.

  • ప్రతి caller ను చూడండి

    Unknown ones సహా ఏ clients ఏ endpoints ను ఉపయోగిస్తున్నారో అర్థం చేసుకోండి.

  • credentials ను వేరుగా ఉంచండి

    API keys మరియు OAuth ఇంకా access ను నిర్ణయిస్తాయి. Actor context ఎవరు call చేస్తున్నారో జోడిస్తుంది.

  • Unknown కోసం ప్రణాళిక

    ప్రతి route లో caller ఉపయోగపడే evidence ఇవ్వనప్పుడు ఏమి జరుగుతుందో నిర్వచించండి.

01 · గుర్తించు

ప్రతి request నుండి evidence.

సర్వర్, ఎడ్జ్ మరియు HTTP API ఇంటిగ్రేషన్లు request signatures, ప్రకటించిన క్లయింట్ వివరాలు మరియు request contextను చదివి, ప్రతి దానికి దాని ఆధారాన్ని లేబుల్ చేస్తాయి.

  • ప్రచురించిన keysతో పోల్చి HTTP message signaturesను verify చేస్తారు.
  • ప్రకటనలుగా నమోదు చేసిన client పేర్లు.
  • మీ server, gateway లేదా edge నుండి request context.
signals · last request per source
  • request signaturevalid · sample-crawler.exampleverified
  • client ప్రకటన"research-assistant/2.1"declared
  • బ్రౌజర్ పరస్పర చర్యpointer + keyboard eventsinferred
  • సపోర్ట్ చేసే signals లేవుroute not instrumentedunknown

02 · అర్థం చేసుకో

ఏ endpoint ను ఎవరు ఉపయోగిస్తున్నారో తెలుసుకోండి.

ప్రతి route లో actor mix, ఏ operators మీకు ఎక్కువగా call చేస్తారో, మరియు unknown callers ఎక్కడ కేంద్రీకృతమవుతున్నాయో చూడండి.

  • route మరియు operator ప్రకారం callers.
  • ప్రతి classification వెనుక ఉన్న evidence.
  • ప్రతి endpoint కు Unknown రేటు.
route వారీగా traffic · 7 days
  • /dashboardతెలియదు 7%
  • /api/v1/catalogతెలియదు 15%
  • /support/ticketsతెలియదు 8%
  • /signupతెలియదు 21%
మనిషిమనిషి + AIఏజెంట్తెలియదు

03 · రూట్ చేయు

ప్రభావానికి సరిపోయే నియంత్రణలు.

route-level policies రాయండి: verified agents కోసం structured responses, declared clients కోసం standard limits, high-impact actions కోసం stronger credentials.

  • రూట్, class మరియు basis ప్రకారం policies.
  • అవసరమైనప్పుడు మరింత బలమైన credentialsకు మారండి.
  • పరిశీలించండి, preview చేయండి, తర్వాత enforce చేయండి.
policy · example-app.test
  • /api/v1/catalogenforceఏజెంట్అనుమతించు · structured API
  • /support/ticketsenforceమనిషి + AIఅనుమతించు · AI-assisted గా label చేయండి
  • /account/*previewతెలియదుప్రస్తుత checks ను అలాగే ఉంచండి
  • /api/v1/orderspreviewఏజెంట్మరింత బలమైన credential ను require చేయండి

ఉదాహరణ నిర్ణయాలు

request నుండి result వరకు, మీ నిర్ణయం వరకు.

  • Verified agent మీ catalog ను చదువుతుంది

    అభ్యర్థన

    GET /api/v1/catalog

    ఫలితం

    ఏజెంట్basis: verified

    మీ నిర్ణయం

    agent rate limit మరియు structured response తో అనుమతించండి.

  • ఒక automated client order ను ఉంచుతోంది

    అభ్యర్థన

    POST /api/v1/orders

    ఫలితం

    ఏజెంట్basis: inferred

    మీ నిర్ణయం

    order సృష్టించే ముందు app యొక్క మరింత బలమైన credential అడగండి.

  • Evidence లేని client

    అభ్యర్థన

    GET /api/v1/catalog

    ఫలితం

    తెలియదుbasis: unknown

    మీ నిర్ణయం

    read-only route: default rate limit తో అనుమతించు.

ప్రమాదం లేకుండా విడుదల చేయండి

బృందాలు observation mode‌లో ప్రారంభించి route by routeగా ముందుకు సాగుతాయి.

  1. 01

    ప్రతి route ను observe చేయండి

    మీ API ముందు middleware లేదా HTTP API ను జోడించండి. signatures, declarations మరియు Unknown callers ప్రతి route కు నమోదు అవుతాయి.

  2. 02

    route policies ను preview చేయండి

    agent rate limits లేదా step-up credentials నిజమైన traffic పై అమలు కాకముందే ఏమి చేసేవో చూడండి.

  3. 03

    ప్రభావం ఆధారంగా అమలు చేయండి

    reads ను తెరిచి ఉంచండి, writes ను కట్టుదిట్టం చేయండి, access పై API keys మరియు OAuth నియంత్రణలో ఉంచండి.

మీ stack తో పనిచేస్తుంది

  • Founding బృందాలు

    వెబ్ సర్వర్ మిడిల్‌వేర్ (Node.js)

    సర్వర్-వైపు

    server-rendered apps మరియు APIs కోసం request-level signals.

  • Founding బృందాలు

    Next.js

    సర్వర్-సైడ్ మరియు ఎడ్జ్

    page మరియు API routes కోసం middleware.

  • Founding బృందాలు

    బ్రౌజర్ స్క్రిప్ట్

    కేవలం బ్రౌజర్ సంకేతాలు

    browser sessions నుంచి interaction signals, server-side integration తో పాటు.

  • Founding బృందాలు

    Cloudflare మరియు edge runtimes

    ఎడ్జ్

    requests మీ originకు చేరుకునే ముందు edge వద్ద signals.

  • Founding బృందాలు

    సాధారణ HTTP API

    ఏ stack అయినా

    request context ను ఒక API కి పంపి, దాని basis తో కూడిన result ను పొందండి.

  • Founding బృందాలు

    MCP సర్వర్

    MCP

    MCP tool calls కోసం Actor context.

  • రోడ్‌మ్యాప్

    WordPress

    Plugin

    WordPress సైట్ల కోసం ప్లగిన్.

  • రోడ్‌మ్యాప్

    native మొబైల్

    iOS మరియు Android

    Native iOS మరియు Android SDKs.

ప్రతి founding team తో onboarding సమయంలో integrations ను ప్రత్యక్షంగా అందిస్తాం. వేరే stack వాడుతున్నారా? దరఖాస్తు చేసేటప్పుడు మాకు తెలియజేయండి.

మరింత తెలుసుకోండి

Detection & Limitations చదవండి

తరచుగా అడిగే ప్రశ్నలు

clients తమ requests ను sign చేయాలా?

లేదు. signed requests అత్యంత బలమైన evidence ఇస్తాయి, కానీ Proof of Actor declarations మరియు inferences ను కూడా నమోదు చేస్తుంది, ప్రతి ఒక్కదాన్నీ దాని basis తో label చేస్తుంది, మరియు సరిపడా లేకపోతే Unknown అని నివేదిస్తుంది.

valid signature అంటే client కు పనిచేయడానికి అనుమతి ఉందని అర్థమా?

లేదు. request ఒక published identifier కు అనుసంధానమైన key తో sign చేయబడిందని ఇది చూపుతుంది. ఆ operator ఏమి చేయగలదో మీ authorization మరియు policy నిర్ణయిస్తాయి.

ఇది API keys లేదా OAuth ను భర్తీ చేస్తుందా?

లేదు. Credentials ఇంకా access ను నియంత్రిస్తాయి. Proof of Actor ఎవరు లేదా ఏమి call చేస్తోంది అనేది జోడిస్తుంది, అందువల్ల మీరు దాని మీద మెరుగైన policies ను వర్తింపజేయవచ్చు.

ప్రతి endpoint కు వేర్వేరు నియమాలు పెట్టగలమా?

అవును. Policies ప్రతి route కి వ్రాయబడతాయి, కాబట్టి read-only endpoints మరియు high-impact writes ను వేరుగా పరిగణించవచ్చు.

దీనికి ఎంత ఖర్చు అవుతుంది?

ఎంచుకున్న founding developer teams agreed usage limits లోపు up to 12 months free పొందవచ్చు.

మీ API ను ఎవరు కాల్ చేస్తున్నారో తెలుసుకోండి.

Proof of Actor founding developer program లో చేరండి.

తొందరగా యాక్సెస్ పొందండిdeveloper hub

ముందుగా మాట్లాడాలనుకుంటున్నారా? foundersతో మాట్లాడండి