உங்கள் API-ஐ யார் call செய்கிறார்கள் என்பதைக் புரிந்து கொள்ளுங்கள்.
ஒவ்வொரு API request க்கும் Actor சூழலை சேர்க்கவும்: எந்த client அழைக்கிறது, evidence எவ்வளவு வலுவானது, மேலும் உங்கள் API அதற்கு என்ன செய்ய வேண்டும், பாதை வாரியாக.
POST /api/v1/orders
சான்று
உலாவி சூழல் இல்லாத API-key போக்குவரத்து மற்றும் தானியக்க request முறை
உங்கள் policy: order ஐ உருவாக்குவதற்கு முன் இன்னும் வலுவான credential ஐக் கேட்கவும்
ஒரு API key என்பது identity அல்ல, மேலும் identity என்பது permission அல்ல.
பெரும்பாலான API traffic ஒரு credential-உடன் வருகிறது, அது எந்த account பணம் செலுத்துகிறது என்பதைக் காட்டுகிறது, எந்த client அழைக்கிறது அல்லது அதற்கு உத்தரவிட்டவர் யார் என்பதைக் காட்டாது. சில clients தங்கள் requests-ஐ கையொப்பமிடுகின்றன, பலர் பெயரை மட்டும் அறிவிக்கின்றனர், மேலும் பலர் எதுவும் சொல்லுவதில்லை.
ஒவ்வொரு API யும் பதிலளிக்க வேண்டிய மூன்று கேள்விகளை Proof of Actor தனித்தனியாகப் பிரிக்கிறது, அதனால் ஒவ்வொன்றுக்கும் சரியான evidence மற்றும் சரியான கட்டுப்பாடு கிடைக்கிறது.
- யார் அழைக்கிறார்?Actor அடையாளம்: signature, declaration அல்லது inference
- எந்த credential?உங்கள் API key, OAuth token அல்லது session
- அது என்ன செய்யக்கூடும்?உங்கள் authorization மற்றும் policy
Proof of Actor முதலாவதற்கு பதிலளிக்கிறது. மற்ற இரண்டையும் உங்கள் stack வைத்துக்கொள்கிறது.
API teams actor context-ஐ என்ன செய்கின்றன
கையொப்பமிட்ட clients-ஐ அடையாளம் காண்
வெளியிடப்பட்ட keys-க்கு எதிராக request signatures-ஐ சரிபார்த்து, ஒரு request எந்த operator-க்கு சொந்தமானது என்பதைப் பார்க்கவும்.
declarations-ஐ declarations-ஆகவே கருதுங்கள்
தாங்களே அறிவித்த client பெயர்களைப் பதிவு செய்து, அவற்றை verified identity இலிருந்து தனியாக வைத்திருங்கள்.
ஒவ்வொரு பாதைக்கும் கொள்கைகள்
குறைந்த தாக்கம் கொண்ட reads ஐ சுதந்திரமாக அனுமதிக்கவும், மேலும் writes மற்றும் high-impact endpoints இல் கூடுதல் தகவலைக் கேட்கவும்.
ஒவ்வொரு caller-யையும் பார்க்கவும்
எந்த clients எந்த endpoints-ஐ பயன்படுத்துகின்றன, unknown ones-ஐ உட்பட, என்பதைக் புரிந்து கொள்ளுங்கள்.
credentials-ஐ தனியாக வைத்திருங்கள்
API keys மற்றும் OAuth இன்னும் அணுகலை நிர்ணயிக்கின்றன. Actor context யார் அழைக்கிறார் என்பதைச் சேர்க்கிறது.
Unknown க்கான திட்டம்
ஒவ்வொரு route-க்கும், ஒரு caller பயன்படக்கூடிய சான்றுகளை வழங்காதபோது என்ன நடக்க வேண்டும் என்பதை வரையறுக்கவும்.
01 · கண்டறி
ஒவ்வொரு request-இலிருந்தும் evidence.
சர்வர், எட்ஜ் மற்றும் HTTP API ஒருங்கிணைப்புகள் கோரிக்கை கையொப்பங்கள், அறிவிக்கப்பட்ட கிளையன்ட் விவரங்கள் மற்றும் கோரிக்கை சூழலைப் படித்து, ஒவ்வொன்றையும் அதன் அடிப்படையுடன் குறிச்சொல்லிடுகின்றன.
- பதியப்பட்ட keys-க்கு எதிராக சரிபார்க்கப்பட்ட HTTP message signatures.
- பிரகடனங்களாக பதிவு செய்யப்பட்ட client பெயர்கள்.
- உங்கள் server, gateway அல்லது edge-இலிருந்து request context-ஐப் பெறவும்.
- கோரிக்கை கையொப்பம்valid · sample-crawler.exampleverified
- வாடிக்கையாளர் அறிவிப்பு"research-assistant/2.1"declared
- உலாவி தொடர்புpointer + keyboard eventsinferred
- ஆதரிக்கப்படும் signals இல்லைroute not instrumentedunknown
02 · புரிந்துகொள்
எந்த endpoint-ஐ யார் பயன்படுத்துகிறார்கள் என்பதை அறிந்துகொள்ளுங்கள்.
ஒவ்வொரு route-இலும் actor mix-ஐப் பாருங்கள், எந்த operators உங்களை அதிகம் தொடர்புகொள்கிறார்கள், மற்றும் unknown callers எங்கு அதிகம் குவிகின்றனர் என்பதையும் காணவும்.
- route மற்றும் operator அடிப்படையில் callers.
- ஒவ்வொரு classification-ன் பின்னாலுள்ள ஆதாரம்.
- ஒவ்வொரு endpoint-க்கும் Unknown rate.
- /dashboardதெரியாதது 7%
- /api/v1/catalogதெரியாதது 15%
- /support/ticketsதெரியாதது 8%
- /signupதெரியாதது 21%
03 · வழிநடத்து
தாக்கத்துக்கு பொருந்தும் கட்டுப்பாடுகள்.
route-level policies-ஐ எழுதுங்கள்: verified agents-க்கு structured responses, declared clients-க்கு standard limits, high-impact actions-க்கு stronger credentials.
- பாதை, class மற்றும் basis அடிப்படையிலான கொள்கைகள்.
- தேவைப்படும் போது இன்னும் வலுவான credentials-க்கு மாறுங்கள்.
- Observe, preview, பின்னர் enforce செய்யுங்கள்.
- /api/v1/catalogenforceமுகவர்அனுமதி · structured API
- /support/ticketsenforceமனிதர் + AIஅனுமதி · AI-assisted என label செய்யவும்
- /account/*previewதெரியாததுஇருக்கும் checks-ஐ வைத்திருங்கள்
- /api/v1/orderspreviewமுகவர்மேலும் வலுவான credential-ஐக் கோரவும்
உதாரண decisions
request-இலிருந்து result-க்கு, பின்னர் உங்கள் decision-க்கு.
ஒரு 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 ஐக் கேட்கவும்.
சான்று இல்லாத கிளையன்ட்
கோரிக்கை
GET /api/v1/catalog
முடிவு
தெரியாததுbasis: unknownஉங்கள் முடிவு
read-only பாதை: default rate limit உடன் allow செய்யவும்.
ஆபத்து இல்லாமல் வெளியிடுங்கள்
அணிகள் observation mode இல் தொடங்கி route by route நகர்கின்றன.
- 01
ஒவ்வொரு route-ஐயும் observe செய்யவும்
உங்கள் API-க்கு முன் middleware அல்லது HTTP API-ஐச் சேர்க்கவும். Signatures, declarations மற்றும் Unknown அழைப்பாளர்கள் ஒவ்வொரு route-க்கும் பதிவு செய்யப்படுகின்றனர்.
- 02
route policies-ஐ preview செய்யவும்
agent rate limits அல்லது step-up credentials உண்மையான traffic-இல் செயல்படுவதற்கு முன் என்ன செய்திருக்கும் என்பதைச் சரிபார்க்கவும்.
- 03
விளைவின் அடிப்படையில் enforce செய்யவும்
reads-ஐ திறந்தவையாக வைத்துக் கொள்ளுங்கள், writes-ஐ கடுமையாக்குங்கள், மற்றும் access-ஐ API keys மற்றும் OAuth கட்டுப்பாட்டில் வைத்துக் கொள்ளுங்கள்.
உங்கள் stack உடன் செயல்படுகிறது
- ஆரம்ப குழுக்கள்
Web server இடைமுக மென்பொருள் (Node.js)
Server-side
server-rendered apps மற்றும் APIs-க்கான request-level signals.
- ஆரம்ப குழுக்கள்
Next.js
சர்வர் பக்கமும் எட்ஜும்
page மற்றும் API routes-க்கான middleware.
- ஆரம்ப குழுக்கள்
உலாவி script
உலாவி signals மட்டும்
server-side integration-உடன் சேர்த்து browser sessions-இல் இருந்து கிடைக்கும் interaction signals.
- ஆரம்ப குழுக்கள்
Cloudflare மற்றும் edge runtimes
எல்லை
கோரிக்கைகள் உங்கள் origin-ஐ அடையுமுன் எட்ஜில் உள்ள சிக்னல்கள்.
- ஆரம்ப குழுக்கள்
பொது HTTP API
எந்த stack ஆனாலும்
request context-ஐ ஒரு API-க்கு அனுப்பி, அதன் basis-உடன் ஒரு முடிவைப் பெறவும்.
- ஆரம்ப குழுக்கள்
MCP சேவையகம்
MCP
MCP tool calls க்கான Actor சூழல்.
- Roadmap
WordPress
Plugin
WordPress தளங்களுக்கான plugin.
- Roadmap
நேட்டிவ் மொபைல்
iOS மற்றும் Android
Native iOS மற்றும் Android SDKs.
ஒவ்வொரு founding team-உடனும் onboarding போது integrations நேரடியாக நடைமுறை ஆதரவுடன் வழங்கப்படுகின்றன. வேறு stack-ஐ பயன்படுத்துகிறீர்களா? விண்ணப்பிக்கும்போது எங்களிடம் சொல்லுங்கள்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
clients தங்களின் requests-ஐ கையொப்பமிட வேண்டுமா?
இல்லை. signed requests மிக வலுவான evidence-ஐ வழங்குகின்றன, ஆனால் Proof of Actor declarations மற்றும் inferences-ஐயும் பதிவு செய்கிறது, ஒவ்வொன்றும் அதன் basis-உடன் label செய்யப்படுகிறது, மேலும் போதுமானது இல்லாதபோது Unknown என அறிக்கையிடுகிறது.
செல்லுபடியாகும் signature என்பது client செயல்பட அனுமதிக்கப்பட்டது என்று அர்த்தமா?
இல்லை. இது request ஒரு வெளியிடப்பட்ட identifier-க்கு இணைக்கப்பட்ட key-யுடன் கையொப்பமிடப்பட்டிருந்ததை காட்டுகிறது. அந்த operator என்ன செய்யலாம் என்பது உங்கள் authorization மற்றும் policy மூலம் தீர்மானிக்கப்படுகிறது.
இது API keys அல்லது OAuth-ஐ மாற்றுமா?
இல்லை. credentials இன்னும் access-ஐ கட்டுப்படுத்துகின்றன. Proof of Actor யார் அல்லது என்ன அழைக்கிறது என்பதைச் சேர்க்கிறது, அதனால் மேலாக சிறந்த policies-ஐப் பயன்படுத்தலாம்.
ஒவ்வொரு endpoint-க்கும் தனித்த விதிகளை அமைக்கலாமா?
ஆம். Policies route-க்கு தனித்தனியாக எழுதப்படுகின்றன, அதனால் read-only endpoints மற்றும் high-impact writes வேறுபட்ட முறையில் கையாளப்படலாம்.
இதற்கான செலவு எவ்வளவு?
தேர்ந்தெடுக்கப்பட்ட founding developer teams-க்கு ஒப்புக்கொள்ளப்பட்ட பயன்பாட்டு வரம்புகளுக்குள் up to 12 months free கிடைக்கலாம்.
உங்கள் API-ஐ யார் அழைக்கிறார்கள் என்பதை அறிந்துகொள்ளுங்கள்.
Proof of Actor founding developer program-இல் சேருங்கள்.
முதலில் பேச விரும்புகிறீர்களா? founders-உடன் பேசுங்கள்