ମୁଖ୍ୟ ବିଷୟବସ୍ତୁକୁ ଛାଡ଼ନ୍ତୁ
APIS

ଆପଣଙ୍କ API କୁ କିଏ call କରୁଛି, ତାହା ବୁଝନ୍ତୁ।

ପ୍ରତ୍ୟେକ API request ରେ ଅଭିନେତା ପରିପ୍ରେକ୍ଷ୍ୟ ଯୋଡନ୍ତୁ: କେଉଁ client କଲ୍ କରୁଛି, ପ୍ରମାଣ କେତେ ଶକ୍ତିଶାଳୀ ଅଛି, ଏବଂ route ଅନୁସାରେ ଆପଣଙ୍କ API କଣ କରିବା ଉଚିତ।

Early Access ପାଆନ୍ତୁଏହା କିପରି କାମ କରେ ଅନୁସନ୍ଧାନ କରନ୍ତୁ
example-app.test · କର୍ତ୍ତା ଫଳାଫଳ

POST /api/v1/orders

ଏଜେଣ୍ଟbasis: inferred

ପ୍ରମାଣ

browser context ବିନା API-key traffic ଏବଂ automated request pattern

ଆପଣଙ୍କ policy: order ସୃଷ୍ଟି କରିବା ପୂର୍ବରୁ ଅଧିକ ଶକ୍ତିଶାଳୀ credential ଚାହନ୍ତୁ

ଏକ API key ପରିଚୟ ନୁହେଁ, ଏବଂ ପରିଚୟ permission ନୁହେଁ।

ଅଧିକାଂଶ API traffic ଏକ credential ସହିତ ଆସେ ଯାହା କେଉଁ account ଦେୟ ଦେଉଛି କହେ, କିନ୍ତୁ କେଉଁ client ଡାକୁଛି କିମ୍ବା କିଏ ତାହାକୁ ନିର୍ଦ୍ଦେଶ ଦେଇଛି ତାହା ନୁହେଁ। କିଛି client ସେମାନଙ୍କର requests କୁ sign କରନ୍ତି, ଅନେକେ କେବଳ ଏକ name declare କରନ୍ତି, ଏବଂ ଅନେକେ କିଛି ମଧ୍ୟ କହନ୍ତି ନାହିଁ।

Proof of Actor ପ୍ରତ୍ୟେକ API ଉତ୍ତର ଦେବାକୁ ପଡ଼ୁଥିବା ତିନିଟି ପ୍ରଶ୍ନକୁ ଅଲଗା କରେ, ଯାହାଦ୍ୱାରା ପ୍ରତ୍ୟେକଟିକୁ ସଠିକ୍ evidence ଏବଂ ସଠିକ୍ control ମିଳେ।

ତିନୋଟି ପୃଥକ ପ୍ରଶ୍ନ
  • କିଏ call କରୁଛି?ଅଭିନେତା ପରିଚୟ: signature, declaration କିମ୍ବା inference
  • କେଉଁ credential?ଆପଣଙ୍କ API key, OAuth token କିମ୍ବା session
  • ଏହା କ'ଣ କରିପାରେ?ଆପଣଙ୍କ authorization ଏବଂ policy

Proof of Actor ପ୍ରଥମଟିର ଉତ୍ତର ଦିଏ। ଆପଣଙ୍କ stack ଅନ୍ୟ ଦୁଇଟିକୁ ରଖେ।

API teams actor context ସହ କ'ଣ କରନ୍ତି

  • ସ୍ୱାକ୍ଷରିତ କ୍ଲାଏଣ୍ଟମାନଙ୍କୁ ଚିହ୍ନଟ କରନ୍ତୁ

    ପ୍ରକାଶିତ keyଗୁଡ଼ିକ ସହିତ request signatureଗୁଡ଼ିକୁ ଯାଞ୍ଚ କରନ୍ତୁ ଏବଂ କେଉଁ operator ସହିତ ଏକ request ସମ୍ବନ୍ଧିତ ଅଛି ତାହା ଦେଖନ୍ତୁ।

  • declarations କୁ declarations ଭାବରେ ହିଁ ଗ୍ରହଣ କରନ୍ତୁ

    ସ୍ୱୟଂ-ଘୋଷିତ client ନାମଗୁଡ଼ିକ ରେକର୍ଡ କରନ୍ତୁ, ଏବଂ ସେଗୁଡ଼ିକୁ verified identity ଠାରୁ ଅଲଗା ରଖନ୍ତୁ।

  • ପ୍ରତ୍ୟେକ route ପାଇଁ policy

    low-impact reads କୁ ସ୍ୱଚ୍ଛନ୍ଦରେ ଅନୁମତି ଦିଅନ୍ତୁ ଏବଂ writes ଏବଂ high-impact endpoints ଉପରେ ଅଧିକ ଚାହନ୍ତୁ।

  • ପ୍ରତ୍ୟେକ caller କୁ ଦେଖନ୍ତୁ

    କେଉଁ client କେଉଁ endpoint ବ୍ୟବହାର କରୁଛି, unknown endpoint ସହିତ ମଧ୍ୟ, ତାହା ବୁଝନ୍ତୁ।

  • credentials କୁ ଅଲଗା ରଖନ୍ତୁ

    API keys ଏବଂ OAuth ତଥାପି access ନିର୍ଣ୍ଣୟ କରେ। Actor context ଯୋଡ଼େ କେଉଁଠାରୁ call ହେଉଛି।

  • Unknown ପାଇଁ ଯୋଜନା

    ପ୍ରତ୍ୟେକ route ରେ caller କୌଣସି ବ୍ୟବହାରଯୋଗ୍ୟ evidence ନ ଦେଲେ କ'ଣ ହେବ ସେଥିରେ ପରିଭାଷା କରନ୍ତୁ।

01 · ଚିହ୍ନଟ

ପ୍ରତ୍ୟେକ request ରୁ evidence।

ସର୍ଭର, edge ଏବଂ HTTP API integrationଗୁଡ଼ିକ request signature, declared client details ଏବଂ request context ପଢ଼େ, ଏବଂ ପ୍ରତ୍ୟେକଟିକୁ ତାହାର ଆଧାର ସହିତ ଚିହ୍ନିତ କରେ।

  • ପ୍ରକାଶିତ key ସହିତ ସତ୍ୟାପିତ HTTP message signature।
  • ଘୋଷଣା ଭାବରେ ରେକର୍ଡ ହୋଇଥିବା ଘୋଷିତ client ନାମଗୁଡ଼ିକ।
  • ଆପଣଙ୍କ server, gateway କିମ୍ବା edge ରୁ request context ପାଆନ୍ତୁ।
ସଙ୍କେତ · ପ୍ରତ୍ୟେକ ଉତ୍ସ ପାଇଁ ସେଷ request
  • ଅନୁରୋଧ ସହିvalid · sample-crawler.exampleverified
  • client ଘୋଷଣା"research-assistant/2.1"declared
  • ବ୍ରାଉଜର ଇଣ୍ଟରାକ୍ସନpointer + keyboard eventsinferred
  • କୌଣସି supported signals ନାହିଁroute not instrumentedunknown

02 · ବୁଝନ୍ତୁ

କିଏ କେଉଁ endpoint ବ୍ୟବହାର କରୁଛି, ତାହା ଜାଣନ୍ତୁ।

ପ୍ରତ୍ୟେକ route ରେ actor mix, କେଉଁ operators ଆପଣଙ୍କୁ ସବୁଠାରୁ ଅଧିକ call କରନ୍ତି, ଏବଂ unknown callers କେଉଁଠାରେ କେନ୍ଦ୍ରୀଭୂତ ହୁଏ ଦେଖନ୍ତୁ।

  • route ଏବଂ operator ଅନୁସାରେ callerମାନେ।
  • ପ୍ରତ୍ୟେକ classification ପଛରେ ଥିବା evidence।
  • ପ୍ରତି endpoint ରେ unknown ହାର।
route ଅନୁସାରେ traffic · 7 days
  • /dashboardଅଜ୍ଞାତ 7%
  • /api/v1/catalogଅଜ୍ଞାତ 15%
  • /support/ticketsଅଜ୍ଞାତ 8%
  • /signupଅଜ୍ଞାତ 21%
ମଣିଷମଣିଷ + AIଏଜେଣ୍ଟଅଜ୍ଞାତ

03 · ପଥନିର୍ଦ୍ଦେଶନ

ପ୍ରଭାବ ସହିତ ମେଳ ରଖୁଥିବା controlଗୁଡ଼ିକ।

route-level policies ଲେଖନ୍ତୁ: verified agents ପାଇଁ structured responses, declared clients ପାଇଁ standard limits, high-impact actions ପାଇଁ ଶକ୍ତିଶାଳୀ credentials।

  • route, class ଏବଂ basis ଅନୁସାରେ policy।
  • ଯେତେବେଳେ ଆବଶ୍ୟକ, ଅଧିକ ଶକ୍ତିଶାଳୀ credentialକୁ ଉଠନ୍ତୁ।
  • Observe କରନ୍ତୁ, preview କରନ୍ତୁ, ତାପରେ enforce କରନ୍ତୁ।
policy · example-app.test
  • /api/v1/catalogenforceଏଜେଣ୍ଟଅନୁମତି ଦିଅନ୍ତୁ · structured API
  • /support/ticketsenforceମଣିଷ + AIଅନୁମତି ଦିଅନ୍ତୁ · AI-assisted label
  • /account/*previewଅଜ୍ଞାତବର୍ତ୍ତମାନର checks କୁ ରଖନ୍ତୁ
  • /api/v1/orderspreviewଏଜେଣ୍ଟଅଧିକ ଶକ୍ତିଶାଳୀ credential ଆବଶ୍ୟକ କରନ୍ତୁ

ଉଦାହରଣ ନିଷ୍ପତ୍ତିଗୁଡ଼ିକ

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 ଚାହନ୍ତୁ।

  • କୌଣସି ପ୍ରମାଣ ନଥିବା client

    ଅନୁରୋଧ

    GET /api/v1/catalog

    ଫଳାଫଳ

    ଅଜ୍ଞାତbasis: unknown

    ଆପଣଙ୍କ ନିଷ୍ପତ୍ତି

    read-only route: default rate limit ସହିତ allow କରନ୍ତୁ।

ଝୁମକି ବିନା rollout କରନ୍ତୁ

ଦଳଗୁଡ଼ିକ observation mode ରେ ଆରମ୍ଭ କରନ୍ତି ଏବଂ route ପରେ route ଆଗକୁ ବଢ଼ନ୍ତି।

  1. 01

    ପ୍ରତ୍ୟେକ route observe କରନ୍ତୁ

    ଆପଣଙ୍କ API ର ସମ୍ମୁଖରେ middleware କିମ୍ବା HTTP API ଯୋଡନ୍ତୁ। Signature, declaration ଏବଂ Unknown caller ପ୍ରତ୍ୟେକ route ପାଇଁ ରେକର୍ଡ ହୁଏ।

  2. 02

    route policy ପୂର୍ବଦର୍ଶନ କରନ୍ତୁ

    ସେଗୁଡ଼ିକ ପ୍ରୟୋଗ ହେବା ପୂର୍ବରୁ real traffic ରେ agent rate limits କିମ୍ବା step-up credential କ'ଣ କରିଥାନ୍ତା ତାହା ଯାଞ୍ଚ କରନ୍ତୁ।

  3. 03

    ପ୍ରଭାବ ଅନୁସାରେ ପ୍ରବଳ କରନ୍ତୁ

    read କୁ ଖୋଲା ରଖନ୍ତୁ, write କୁ କଠୋର କରନ୍ତୁ, ଏବଂ access ଉପରେ API key ଏବଂ OAuth କୁ ଦାୟିତ୍ୱରେ ରଖନ୍ତୁ।

ଆପଣଙ୍କ stack ସହ କାମ କରେ

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    ୱେବ୍ ସର୍ଭର ମିଡଲୱେର୍ (Node.js)

    server-side

    server-rendered apps ଏବଂ APIs ପାଇଁ request-level ସିଗ୍ନାଲ୍।

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    Next.js

    server-side ଏବଂ edge

    page ଏବଂ API routes ପାଇଁ middleware।

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    ବ୍ରାଉଜର ସ୍କ୍ରିପ୍ଟ

    କେବଳ browser signals

    Browser sessions ରୁ interaction signals, ଏକ server-side integration ସହିତ।

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    Cloudflare ଏବଂ edge runtimeଗୁଡ଼ିକ

    Edge

    requestଗୁଡ଼ିକ ଆପଣଙ୍କ origin କୁ ପହଞ୍ଚିବା ପୂର୍ବରୁ edge ରେ signal।

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    ସାଧାରଣ HTTP API

    ଯେକୌଣସି stack

    ଏକ API କୁ request context ପଠାନ୍ତୁ ଏବଂ ତାହାର basis ସହିତ ଏକ result ପାଆନ୍ତୁ।

  • ପ୍ରତିଷ୍ଠାତା ଟିମ୍ଗୁଡ଼ିକ

    MCP ସେର୍ଭର

    MCP

    MCP tool calls ପାଇଁ ଅଭିନେତା ପରିପ୍ରେକ୍ଷ୍ୟ।

  • ରୋଡମ୍ୟାପ

    WordPress

    Plugin

    WordPress site ପାଇଁ plugin।

  • ରୋଡମ୍ୟାପ

    native mobile

    iOS ଏବଂ Android

    Native iOS ଏବଂ Android SDKs।

Onboarding ସମୟରେ ପ୍ରତ୍ୟେକ founding team ସହ integrations hands-on ଭାବରେ ପ୍ରଦାନ କରାଯାଏ। ଅନ୍ୟ stack ବ୍ୟବହାର କରୁଛନ୍ତି? ଆବେଦନ କରିବାବେଳେ ଆମକୁ କୁହନ୍ତୁ।

ଅଧିକ ଜାଣନ୍ତୁ

Detection & Limitations ପଢନ୍ତୁ

ସାଧାରଣ ପ୍ରଶ୍ନଗୁଡ଼ିକ

clientମାନଙ୍କୁ ତାଙ୍କର request ଗୁଡ଼ିକ ସାଇନ୍ କରିବାକୁ ପଡିବ କି?

ନାହିଁ। Signed requests ସବୁଠାରୁ ଶକ୍ତିଶାଳୀ evidence ଦେଇଥାଏ, କିନ୍ତୁ Proof of Actor declarations ଏବଂ inferences କୁ ମଧ୍ୟ record କରେ, ପ୍ରତ୍ୟେକକୁ ତାହାର basis ସହ labeled କରେ, ଏବଂ ପର୍ଯ୍ୟାପ୍ତ ନଥିଲେ Unknown report କରେ।

ବ valid signature ର ଅର୍ଥ ହେଲା client କୁ କାର୍ଯ୍ୟ କରିବାକୁ ଅନୁମତି ମିଳିଛି କି?

ନାହିଁ। ଏହା ଦେଖାଏ ଯେ request ଏକ published identifier ସହିତ tied ଥିବା key ଦ୍ୱାରା signed ହୋଇଛି। ସେ operator କ’ଣ କରିପାରିବ ତାହା ଆପଣଙ୍କ authorization ଏବଂ policy ଦ୍ୱାରା ନିର୍ଣ୍ଣୟ ହୁଏ।

ଏହା API keys କିମ୍ବା OAuth କୁ ପ୍ରତିସ୍ଥାପିତ କରେ କି?

ନାହିଁ। Credentials ଏବେଭଳି access କୁ control କରେ। Proof of Actor କିଏ କିମ୍ବା କ’ଣ ଡାକୁଛି ତାହା ଯୋଗ କରେ, ଯାହାଫଳରେ ଆପଣ ଉପରେ ଅଧିକ ଭଲ policies apply କରିପାରିବେ।

ଆମେ ପ୍ରତ୍ୟେକ endpoint ପାଇଁ ଭିନ୍ନ ନିୟମ ସେଟ୍ କରିପାରିବୁ କି?

ହଁ। Policies ପ୍ରତି route ଭିତ୍ତିକ ଲେଖାଯାଏ, ସେଥିପାଇଁ read-only endpoints ଏବଂ high-impact writes କୁ ଭିନ୍ନଭାବେ ଚିକିତ୍ସା କରାଯାଇପାରେ।

ଏହାର ମୂଲ୍ୟ କେତେ?

ଚୟିତ founding developer teams agreed usage limits ମଧ୍ୟରେ up to 12 months free ପାଇପାରିବେ।

ଆପଣଙ୍କ API କୁ କିଏ call କରୁଛି, ତାହା ଜାଣନ୍ତୁ।

Proof of Actor founding developer program ରେ ଯୋଗଦିଅନ୍ତୁ।

Early Access ପାଆନ୍ତୁଡେଭେଲପର୍ କେନ୍ଦ୍ର

ପ୍ରଥମେ କଥାହେବାକୁ ପସନ୍ଦ କରନ୍ତି? founderମାନଙ୍କ ସହ କଥାବାର୍ତ୍ତା କରନ୍ତୁ