முக்கிய உள்ளடக்கத்திற்கு தவிர்க்கவும்
APIS

உங்கள் API-ஐ யார் call செய்கிறார்கள் என்பதைக் புரிந்து கொள்ளுங்கள்.

ஒவ்வொரு API request க்கும் Actor சூழலை சேர்க்கவும்: எந்த client அழைக்கிறது, evidence எவ்வளவு வலுவானது, மேலும் உங்கள் API அதற்கு என்ன செய்ய வேண்டும், பாதை வாரியாக.

example-app.test · actor result

POST /api/v1/orders

முகவர்basis: inferred

சான்று

உலாவி சூழல் இல்லாத 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-ஐப் பெறவும்.
signals · last request per source
  • கோரிக்கை கையொப்பம்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.
route அடிப்படையிலான traffic · 7 நாட்கள்
  • /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 அடிப்படையிலான கொள்கைகள்.
  • தேவைப்படும் போது இன்னும் வலுவான credentials-க்கு மாறுங்கள்.
  • 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-ஐக் கோரவும்

உதாரண 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 நகர்கின்றன.

  1. 01

    ஒவ்வொரு route-ஐயும் observe செய்யவும்

    உங்கள் API-க்கு முன் middleware அல்லது HTTP API-ஐச் சேர்க்கவும். Signatures, declarations மற்றும் Unknown அழைப்பாளர்கள் ஒவ்வொரு route-க்கும் பதிவு செய்யப்படுகின்றனர்.

  2. 02

    route policies-ஐ preview செய்யவும்

    agent rate limits அல்லது step-up credentials உண்மையான traffic-இல் செயல்படுவதற்கு முன் என்ன செய்திருக்கும் என்பதைச் சரிபார்க்கவும்.

  3. 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-உடன் பேசுங்கள்