ਮੁੱਖ ਸਮੱਗਰੀ 'ਤੇ ਜਾਓ
APIS

ਸਮਝੋ ਕਿ ਤੁਹਾਡੀ API ਨੂੰ ਕੌਣ call ਕਰ ਰਿਹਾ ਹੈ।

ਹਰ API request ਵਿੱਚ ਐਕਟਰ ਸੰਦਰਭ ਸ਼ਾਮਲ ਕਰੋ: ਕਿਹੜਾ client call ਕਰ ਰਿਹਾ ਹੈ, evidence ਕਿੰਨਾ ਮਜ਼ਬੂਤ ਹੈ, ਅਤੇ ਤੁਹਾਡਾ API ਇਸ ਬਾਰੇ ਕੀ ਕਰੇ, ਰੂਟ-ਦਰ-ਰੂਟ।

ਅਗਾਊਂ ਪਹੁੰਚ ਲਵੋਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ ਵੇਖੋ
example-app.test · actor result

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 call ਕਰ ਰਿਹਾ ਹੈ ਜਾਂ ਕਿਸ ਨੇ ਉਸਨੂੰ ਹੁਕਮ ਦਿੱਤਾ। ਕੁਝ clients ਆਪਣੇ requests sign ਕਰਦੇ ਹਨ, ਕਈ ਸਿਰਫ਼ ਇੱਕ ਨਾਮ 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 ਨਾਲ ਕੀ ਕਰਦੇ ਹਨ

  • ਦਸਤਖਤ ਕੀਤੇ clients ਨੂੰ ਪਛਾਣੋ

    request signatures ਨੂੰ published keys ਦੇ ਖਿਲਾਫ਼ ਚੈੱਕ ਕਰੋ ਅਤੇ ਦੇਖੋ ਕਿ ਕੋਈ request ਕਿਸ operator ਨਾਲ ਸੰਬੰਧਤ ਹੈ।

  • declarations ਨੂੰ declarations ਵਜੋਂ ਹੀ ਮੰਨੋ

    ਖੁਦ-ਘੋਸ਼ਿਤ client ਨਾਮ ਦਰਜ ਕਰੋ, ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ verified identity ਤੋਂ ਵੱਖ ਰੱਖੋ।

  • ਹਰ route ਲਈ ਨੀਤੀਆਂ

    low-impact reads ਨੂੰ ਖੁੱਲ੍ਹ ਕੇ ਮਨਜ਼ੂਰ ਕਰੋ ਅਤੇ writes ਅਤੇ high-impact endpoints 'ਤੇ ਹੋਰ ਦੀ ਮੰਗ ਕਰੋ।

  • ਹਰ caller ਵੇਖੋ

    ਸਮਝੋ ਕਿ ਕਿਹੜੇ clients ਕਿਹੜੇ endpoints ਵਰਤਦੇ ਹਨ, ਜਿਸ ਵਿੱਚ unknown ones ਵੀ ਸ਼ਾਮਲ ਹਨ।

  • credentials ਵੱਖਰੇ ਰੱਖੋ

    API keys ਅਤੇ OAuth ਹਾਲੇ ਵੀ access ਦਾ ਫ਼ੈਸਲਾ ਕਰਦੇ ਹਨ। Actor context ਇਹ ਜੋੜਦਾ ਹੈ ਕਿ ਕੌਣ call ਕਰ ਰਿਹਾ ਹੈ।

  • Unknown ਲਈ ਯੋਜਨਾ

    ਹਰ route ਲਈ ਇਹ ਨਿਰਧਾਰਤ ਕਰੋ ਕਿ ਜਦ caller ਕੋਈ ਵਰਤੋਂਯੋਗ evidence ਨਾ ਦੇਵੇ ਤਾਂ ਕੀ ਹੁੰਦਾ ਹੈ।

01 · ਪਛਾਣੋ

ਹਰ request ਤੋਂ evidence।

ਸਰਵਰ, edge ਅਤੇ HTTP API ਇੰਟੀਗ੍ਰੇਸ਼ਨ request signatures, declared client details ਅਤੇ request context ਨੂੰ ਪੜ੍ਹਦੇ ਹਨ, ਅਤੇ ਹਰ ਇੱਕ ਨੂੰ ਉਸਦੇ ਆਧਾਰ ਨਾਲ ਲੇਬਲ ਕਰਦੇ ਹਨ।

  • ਪ੍ਰਕਾਸ਼ਿਤ keys ਦੇ ਖ਼ਿਲਾਫ਼ HTTP message signatures ਦੀ ਪੁਸ਼ਟੀ ਕੀਤੀ ਗਈ।
  • ਘੋਸ਼ਿਤ client ਨਾਮ, declarations ਵਜੋਂ ਦਰਜ ਕੀਤੇ ਗਏ।
  • ਆਪਣੇ server, gateway ਜਾਂ edge ਤੋਂ request context ਪ੍ਰਾਪਤ ਕਰੋ।
signals · source ਪ੍ਰਤੀ last request
  • request signaturevalid · sample-crawler.exampleverified
  • client ਘੋਸ਼ਣਾ"research-assistant/2.1"declared
  • browser interactionpointer + keyboard eventsinferred
  • ਕੋਈ supported 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 · ਰੂਟ ਕਰੋ

ਅਜਿਹੇ controls ਜੋ ਪ੍ਰਭਾਵ ਦੇ ਅਨੁਸਾਰ ਹਨ।

route-ਸਤਰ policies ਲਿਖੋ: verified agents ਲਈ structured responses, declared clients ਲਈ standard limits, high-impact actions ਲਈ stronger credentials।

  • route, class ਅਤੇ basis ਅਨੁਸਾਰ ਨੀਤੀਆਂ।
  • ਜਦੋਂ ਲੋੜ ਹੋਵੇ, stronger credentials ਵੱਲ step up ਕਰੋ।
  • 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 ਤੋਂ ਤੁਹਾਡੇ 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 ਮੰਗੋ।

  • ਬਿਨਾਂ evidence ਵਾਲਾ client

    ਬੇਨਤੀ

    GET /api/v1/catalog

    ਨਤੀਜਾ

    ਅਣਜਾਣbasis: unknown

    ਤੁਹਾਡਾ ਫੈਸਲਾ

    read-only route: ਮੂਲ rate limit ਨਾਲ allow ਕਰੋ।

ਬਿਨਾਂ ਜੋਖਮ ਦੇ ਲਾਗੂ ਕਰੋ

ਟੀਮਾਂ observation mode ਵਿੱਚ ਸ਼ੁਰੂ ਕਰਦੀਆਂ ਹਨ ਅਤੇ route ਦਰ route ਅੱਗੇ ਵਧਦੀਆਂ ਹਨ।

  1. 01

    ਹਰ route ਨੂੰ observe ਕਰੋ

    ਤੁਹਾਡੇ API ਦੇ ਸਾਹਮਣੇ middleware ਜਾਂ HTTP API ਸ਼ਾਮਲ ਕਰੋ। signatures, declarations ਅਤੇ Unknown callers ਹਰ route ਅਨੁਸਾਰ ਦਰਜ ਹੁੰਦੇ ਹਨ।

  2. 02

    route policies ਦਾ preview ਕਰੋ

    ਇਹ ਲਾਗੂ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ real traffic 'ਤੇ check ਕਰੋ ਕਿ agent rate limits ਜਾਂ step-up credentials ਕੀ ਕਰਦੇ।

  3. 03

    ਅਸਰ ਦੇ ਅਧਾਰ 'ਤੇ enforce ਕਰੋ

    reads ਨੂੰ ਖੁੱਲ੍ਹਾ ਰੱਖੋ, writes ਨੂੰ ਸਖ਼ਤ ਕਰੋ, ਅਤੇ access ਦੀ ਜ਼ਿੰਮੇਵਾਰੀ API keys ਅਤੇ OAuth ਕੋਲ ਰਹਿਣ ਦਿਓ।

ਤੁਹਾਡੇ stack ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    ਵੈੱਬ ਸਰਵਰ ਮਿਡਲਵੇਅਰ (Node.js)

    server-side

    server-rendered apps ਅਤੇ APIs ਲਈ request-level signals।

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    Next.js

    ਸਰਵਰ-ਸਾਈਡ ਅਤੇ edge

    ਪੇਜ ਅਤੇ API routes ਲਈ middleware।

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    browser script

    ਸਿਰਫ browser signals

    browser sessions ਤੋਂ interaction signals, ਇੱਕ server-side integration ਦੇ ਨਾਲ।

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    Cloudflare ਅਤੇ edge runtimes

    Edge

    requests ਦੇ ਤੁਹਾਡੇ origin ਤੱਕ ਪਹੁੰਚਣ ਤੋਂ ਪਹਿਲਾਂ edge 'ਤੇ signals।

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    ਆਮ HTTP API

    ਕੋਈ ਵੀ stack

    request context ਨੂੰ ਇੱਕ API ਨੂੰ ਭੇਜੋ ਅਤੇ ਉਸ ਦੇ basis ਸਮੇਤ ਨਤੀਜਾ ਪ੍ਰਾਪਤ ਕਰੋ।

  • ਸੰਸਥਾਪਕ ਟੀਮਾਂ

    MCP ਸਰਵਰ

    MCP

    MCP tool calls ਲਈ ਐਕਟਰ ਸੰਦਰਭ।

  • ਰੋਡਮੈਪ

    WordPress

    Plugin

    WordPress ਸਾਈਟਾਂ ਲਈ plugin।

  • ਰੋਡਮੈਪ

    ਮੂਲ ਮੋਬਾਈਲ

    iOS ਅਤੇ Android

    Native iOS ਅਤੇ Android SDKs।

ਹਰ founding team ਨਾਲ onboarding ਦੌਰਾਨ integrations ਹੱਥੋਂ-ਹੱਥ ਦਿੱਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਕੋਈ ਹੋਰ stack ਵਰਤ ਰਹੇ ਹੋ? apply ਕਰਦੇ ਸਮੇਂ ਸਾਨੂੰ ਦੱਸੋ।

ਹੋਰ ਜਾਣੋ

Detection ਅਤੇ ਸੀਮਾਵਾਂ ਪੜ੍ਹੋ

ਅਕਸਰ ਪੁੱਛੇ ਜਾਂਦੇ ਸਵਾਲ

ਕੀ clients ਨੂੰ ਆਪਣੇ requests 'ਤੇ ਦਸਤਖਤ ਕਰਨ ਦੀ ਲੋੜ ਹੈ?

ਨਹੀਂ। Signed requests ਸਭ ਤੋਂ ਮਜ਼ਬੂਤ evidence ਦਿੰਦੇ ਹਨ, ਪਰ Proof of Actor declarations ਅਤੇ inferences ਵੀ record ਕਰਦਾ ਹੈ, ਹਰ ਇੱਕ ਨੂੰ ਉਸਦੇ basis ਨਾਲ label ਕਰਦਾ ਹੈ, ਅਤੇ ਜਦੋਂ ਕਾਫ਼ੀ ਨਾ ਹੋਵੇ ਤਾਂ Unknown report ਕਰਦਾ ਹੈ।

ਕੀ ਇੱਕ valid signature ਦਾ ਮਤਲਬ ਹੈ ਕਿ client ਨੂੰ ਕਾਰਵਾਈ ਕਰਨ ਦੀ ਆਗਿਆ ਹੈ?

ਨਹੀਂ। ਇਹ ਦਿਖਾਉਂਦਾ ਹੈ ਕਿ request ਇੱਕ ਐਸੀ key ਨਾਲ signed ਸੀ ਜੋ ਇੱਕ published identifier ਨਾਲ ਜੁੜੀ ਹੋਈ ਸੀ। ਉਹ operator ਕੀ ਕਰ ਸਕਦਾ ਹੈ, ਇਹ ਤੁਹਾਡੇ authorization ਅਤੇ policy ਦੁਆਰਾ ਨਿਰਧਾਰਤ ਹੁੰਦਾ ਹੈ।

ਕੀ ਇਹ API keys ਜਾਂ OAuth ਦੀ ਥਾਂ ਲੈਂਦਾ ਹੈ?

ਨਹੀਂ। Credentials ਹਾਲੇ ਵੀ access ਨੂੰ control ਕਰਦੇ ਹਨ। Proof of Actor ਦੱਸਦਾ ਹੈ ਕਿ ਕੌਣ ਜਾਂ ਕੀ call ਕਰ ਰਿਹਾ ਹੈ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਉੱਪਰੋਂ ਵਧੀਆ policies ਲਾਗੂ ਕਰ ਸਕੋ।

ਕੀ ਅਸੀਂ ਹਰ endpoint ਲਈ ਵੱਖਰੇ rules ਸੈੱਟ ਕਰ ਸਕਦੇ ਹਾਂ?

ਹਾਂ। Policies ਪ੍ਰਤੀ route ਲਿਖੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਇਸ ਲਈ read-only endpoints ਅਤੇ high-impact writes ਨੂੰ ਵੱਖਰੇ ਤਰੀਕੇ ਨਾਲ ਸੰਭਾਲਿਆ ਜਾ ਸਕਦਾ ਹੈ।

ਇਸ ਦੀ ਕੀਮਤ ਕੀ ਹੈ?

ਚੁਣੀਆਂ ਹੋਈਆਂ founding developer teams agreed usage limits ਦੇ ਅੰਦਰ 12 ਮਹੀਨੇ ਤੱਕ ਮੁਫ਼ਤ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦੀਆਂ ਹਨ।

ਜਾਣੋ ਤੁਹਾਡੇ API ਨੂੰ ਕੌਣ call ਕਰ ਰਿਹਾ ਹੈ।

Proof of Actor founding developer program ਵਿੱਚ ਸ਼ਾਮਲ ਹੋਵੋ।

ਅਗਾਊਂ ਪਹੁੰਚ ਲਵੋਡਿਵੈਲਪਰ ਕੇਂਦਰ

ਪਹਿਲਾਂ ਗੱਲ ਕਰਨੀ ਪਸੰਦ ਕਰੋਗੇ? founders ਨਾਲ ਗੱਲ ਕਰੋ