డెవలపర్‌ల కోసం

కోడ్ నుండి మీరు నిర్వహించగల హోస్టింగ్

జిన్ డిజిటల్® (Zinn Digital®) అనేది ఒక API-ఫస్ట్ ప్లాట్‌ఫారమ్. మా డ్యాష్‌బోర్డ్‌ను నడిపించే అదే ఇంజిన్ API మీకు కూడా లభిస్తుంది — వెర్షన్‌తో కూడినది, స్పెక్-ఫస్ట్ మరియు బిల్డ్ సమయంలో 100% డాక్యుమెంట్ చేయబడినది, దీనిపై జనరేట్ చేయబడిన SDKలు, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, సైన్ చేయబడిన వెబ్‌హుక్స్ మరియు MCP సర్వర్ ఉంటాయి. మీరు పని చేయడానికిేది ఉపయోగించినా — టెర్మినల్, పైప్‌లైన్, స్టేట్ ఫైల్ లేదా AI ఏజెంట్ — ప్లాట్‌ఫారమ్ దానికి అనుగుణంగా స్పందిస్తుంది.

  • 650,000+ప్రపంచవ్యాప్తంగా హోస్ట్ చేయబడిన సైట్‌లు
  • 1ప్రతి టూల్ రూపొందించబడిన OpenAPI స్పెక్
  • 4క్లయంట్ SDKలు — TypeScript, Python, PHP, Go
  • OAuth 2.1పరిధిగల, రద్దు చేయగల AI-ఏజెంట్ యాక్సెస్

ఒక API. ప్రతి ఉపరితలం దానిపైనే నడుస్తుంది.

చాలా మంది హోస్ట్‌లు కంట్రోల్ ప్యానెల్‌పై తర్వాత APIని జోడిస్తారు, మరియు అది స్పష్టంగా కనిపిస్తుంది — ప్యానెల్ ఫీచర్లలో సగానికి పైగా ఎప్పటికీ బయటపడవు. మేము దీనికి విరుద్ధంగా నిర్మించాము. డాష్‌బోర్డ్, అడ్మిన్ కన్సోల్, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, MCP సర్వర్ మరియు మీ స్వంత ఇంటిగ్రేషన్‌లు అన్నీ ఒకే ఇంజిన్ APIని ఉపయోగిస్తాయి. మీరు దీన్ని ప్యానెల్‌లో చేయగలిగితే, మీరు దీన్ని కోడ్‌లో కూడా చేయవచ్చు.

ముందుగా స్పెసిఫికేషన్, తర్వాత డాక్యుమెంటేషన్ కాదు

OpenAPI స్పెసిఫికేషన్ అనేది మూల సత్యం, మరియు అది స్పెసిఫికేషన్‌లో ఉంటేనే తప్ప ఏ ఎండ్‌పాయింట్ కూడా విడుదల కాదు. ఆ ఒక్క నియమం వల్లే పబ్లిక్ API ఎవెంచ్యువల్‌గా కాకుండా బిల్డ్ సమయంలోనే పూర్తిగా డాక్యుమెంట్ చేయబడుతుంది — ఎందుకంటే డాక్యుమెంట్ చేయని ఎండ్‌పాయింట్ అనేది ఉనికిలో ఉండదు కాబట్టి, డాక్యుమెంట్ చేయని మూలంటూ ఏదీ ఉండదు.

తయారు చేయబడింది, మానవీయంగా నిర్వహించబడలేదు

ఇంటరాక్టివ్ రిఫరెన్స్ డాక్స్, నాలుగు క్లైంట్ SDKలు, CLIలో ఎక్కువ భాగం మరియు టెర్రాఫార్మ్ ప్రొవైడర్ స్కాఫోల్డింగ్ అన్నీ ఆ ఒక్క స్పెసిఫికేషన్ నుండే జనరేట్ చేయబడతాయి. ఒకే సోర్స్, అనేక ఆర్టిఫాక్ట్‌లు, ఎల్లప్పుడూ సింక్‌లో ఉంటాయి — మీరు ఇంప్లిమెంటేషన్ నుండి వేరుపడిన డాక్ కోసం ఎప్పటికీ వెతకాల్సిన అవసరం లేదు.

తొలగింపు విధానంతో వెర్షన్‌ చేయబడింది

/v1 కింద ఎండ్-పాయింట్లు అందుబాటులో ఉంటాయి, వీటి కోసం ఒక ప్రచురించబడిన నిలిపివేత విధానం మరియు ఛేంజ్‌లాగ్ ఉంటాయి. ఫెయిల్ అయిన బిల్డ్ ద్వారా తెలుసుకునే బదులు, ఏదైనా మారే ముందు మీకు వ్రాతపూర్వకంగా తెలియజేయబడుతుంది.

CIలో కాంట్రాక్ట్-పరీక్షించబడింది

అమలు-మరియు-స్పెసిఫికేషన్ కాంట్రాక్ట్ పరీక్షలు మరియు OpenAPI లింటింగ్ ప్రతి మార్పుపై రన్ అవుతాయి. కోడ్ మరియు కాంట్రాక్ట్ మధ్య తేడా (డ్రిఫ్ట్) బిల్డ్‌ను ఫెయిల్ చేస్తుంది — కాబట్టి మీరు మీ క్లైంట్‌ను జనరేట్ చేసే స్పెసిఫికేషన్ సర్వర్ వాస్తవంగా గౌరవించే స్పెసిఫికేషన్ అవుతుంది.

అరైజేషన్, స్కోపింగ్ మరియు భారీ స్థాయిలో ఇబ్బంది పెట్టే అంశాలు

లోపలికి వెళ్లడానికి రెండు మార్గాలు, వాటి వెనుక ఉన్న ఒకే ఒక సూత్రం. మీరు ఏది ఉపయోగించినా, అదే అనుమతి తనిఖీలు మరియు అదే డేటాబేస్-స్థాయి ఐసోలేషన్ వర్తిస్తాయి.

సంస్థ వారీగా API కీలు

కీలు zdk_<mode>_<prefix>_<secret> వలె కనిపిస్తాయి. రహస్య పదానికి సంబంధించిన SHA-256 హ్యాష్ మాత్రమే నిల్వ చేయబడుతుంది — కీ జారీ చేసిన తర్వాత దాన్ని మేము మళ్లీ చూపలేము, మా డేటాబేస్‌ను చేరుకునే ఎవరూ కూడా దాన్ని చూపలేరు. కీలు స్కోప్‌లను కలిగి ఉంటాయి, రద్దు చేయబడతాయి మరియు ప్రతి వ్యక్తికి బదులుగా ప్రతి సంస్థకు జారీ చేయబడతాయి.

లైవ్ మరియు టెస్ట్ మోడ్‌లు, వేరుగా ఉంచబడ్డాయి

శాన్‌బాక్స్ కీలు ప్రొడక్షన్ కీలకు భిన్నంగా ఉంటాయి మరియు శాన్‌బాక్స్ మోడ్‌లో రన్ అవుతాయి: నిజమైన బిల్లింగ్ ఉండదు, నిజమైన ప్రొవిజనింగ్ ఉండదు. మీ ఇంటిగ్రేషన్ టెస్ట్‌లు డబ్బు ఖర్చు చేయకుండా లేదా సర్వర్‌లను బిల్డ్ చేయకుండా APIని పూర్తిగా ఉపయోగించుకోవచ్చు.

మానవుల కోసం OIDC

Keycloak జారీ చేసిన JWT లతో యూజర్ సెషన్‌లు ప్రమాణీకరించబడతాయి, ఇవి రీలమ్ పబ్లిక్ కీతో సరిచూడబడతాయి మరియు API కీ ఏ Principal ఆబ్జెక్ట్‌ను పొందుతుందో అదే ఆబ్జెక్ట్‌ను పొందుతాయి. ఎండ్‌పాయింట్‌లు sites.create లేదా apikeys.manage వంటి నిర్దిష్ట అనుమతి కీలపై ఆధారపడి నియంత్రించబడతాయి, ఇవి ప్రతి సంస్థకు వేరువేరుగా తనిఖీ చేయబడతాయి — ఒక సంస్థలోని అనుమతి మరొక సంబంధం లేని సంస్థలో ఎటువంటి యాక్సెస్‌ను మంజూరు చేయదు, అయితే ఇది దాని కింద ఉన్న సంస్థలకు వర్తిస్తుంది.

దిగువన వరుస-స్థాయి భద్రత

ప్రతి టెనెంట్ అభ్యర్థన ప్రిన్సిపాల్ నుండి సెట్ చేయబడిన పోస్ట్‍గ్రేస్ ఆర్గ్ స్కోప్‌తో కూడిన ట్రాన్సాక్షన్‌లో రన్ అవుతుంది, కాబట్టి ఐసోలేషన్ డేటాబేస్ ద్వారా అమలు చేయబడుతుంది, ఎవరైనా మరచిపోయే ORM ఫిల్టర్ ద్వారా కాదు. క్వెరీసెట్ ఫిల్టర్ ఇంకా లోతైన రక్షణగా ఉంది.

డెమోల కోసం మాత్రమే కాకుండా, మెషీన్‌ల కోసం రూపొందించబడింది

READMEలో చూడటానికి ఒక APIని అందంగా తీర్చిదిద్దడం సులభం, కానీ నిజమైన ట్రాఫిక్ కింద అది సరిగ్గా పనిచేసేలా చేయడం కష్టం. తెల్లవారుజామున మూడింటికి ఇంటిగ్రేషన్లు విఫలమయ్యే భాగాలు అవే కాబట్టి, మేము వాటిపైనే ప్రత్యేకంగా శ్రమించాము.

ఈ వివరాలను ప్రత్యేకంగా ప్రస్తావించడం ముఖ్యం, ఎందుకంటే ఇది బల్క్ వర్క్ ప్రవర్తనను ప్రభావితం చేస్తుంది: డూప్లికేట్ డొమైన్‌పై వచ్చే 409 ఏదైనా టెనెంట్ కోసం "ఈ హోస్ట్‌నేమ్ ఇక్కడ హోస్ట్ చేయబడిందా?" అని సమాధానం ఇస్తుంది, ఇది ఒక ఎన్యుమరేషన్ ఒరాకిల్ మరియు Footprint-Freeకి వ్యతిరేకంగా నిజమైన డీ-అనామినిజేషన్ రిస్క్. సైట్ సృష్టిని నిరోధించడం అనేది సులభమైన పరిష్కారంగా ఉండేది మరియు అది బల్క్-ప్రొవిజనింగ్ ఉత్పత్తిని పూర్తిగా దెబ్బతీసేది. దీనికి బదులుగా తిరస్కరించబడిన డూప్లికేట్-డొమైన్ ప్రయత్నాలకు మాత్రమే ప్రతి ప్రిన్సిపాల్ వారీగా బడ్జెట్ కేటాయించబడుతుంది. విజయవంతమైన క్రియేషన్‌లకు ఎప్పుడూ ఛార్జ్ చేయబడవు - కాబట్టి మీరు రోజంతా బల్క్‌లో ప్రొవిజన్ చేయవచ్చు, మరియు ప్రోబింగ్ దాదాపు వెంటనే నిలిచిపోతుంది.

  • ప్రతి వైఫల్యంపై ఒకే రకమైన ఎర్రర్ ఎన్వలప్: కోడ్, మానవ చదవగలిగే సందేశం, ఐచ్ఛిక ఫీల్డ్-స్థాయి వివరాలు మరియు మీరు సపోర్ట్‌కు అందించగల request_id. ధ్రువీకరణ లోపాలు తప్పు చేసిన ఫీల్డ్‌ల పేరుతో 422ని అందిస్తాయి.
  • POSTపై ఐడెంపోటెన్సీ కీలు, ఇన్‌లైన్‌కు బదులుగా కమిట్ సమయంలో రీప్లే రికార్డ్ వ్రాయబడుతుంది - కాబట్టి ఎప్పటికీ కమిట్ కాని రో పేరును సూచించే క్యాష్ చేయబడిన 201ని రీట్రై ఎప్పటికీ రీప్లే చేయలేదు. విఫలమైన అభ్యర్థన దాని ఇన్‌ఫ్లైట్ లాక్‌ను వెంటనే విడుదల చేస్తుంది, కాబట్టి 422 మీ సరిదిద్దబడిన రీట్రైను లాక్ చేయదు.
  • UUIDv7 పై కీసెట్‌గా కర్సర్ పేజినేషన్ — ఏకకాల వ్రాతల క్రింద స్థిరంగా ఉంటుంది, స్కాన్ మధ్యలో అడ్డు వరుసలను చేర్చినప్పుడు పేజ్-డ్రిఫ్ట్ ఉండదు.
  • ప్రతిస్పందనలపై RateLimit-Remaining, తద్వారా రూపొందించబడిన క్లయింట్ ఊహించడం కాకుండా తెలివిగా వెనక్కి తగ్గగలదు.
  • పరిధికి వెలుపల ఉన్న వనరులు 403 బదులుగా 404ని అందిస్తాయి — 403 అయితే ఆ వనరు ఉందని నిర్ధారిస్తుంది. మీ పరిధికి వెలుపల ఉన్న సంస్థ ద్వారా ఫిల్టర్ చేయడం కూడా అదే కారణంగా ఖాళీ పేజీని అందిస్తుంది.
  • సైట్ సృష్టి అనేది రిజిస్ట్రేషన్, ప్రొవిజనింగ్ కాదు: POST /v1/sites అనేది పెండింగ్ స్థితితో 201ని అందిస్తుంది మరియు బిల్డ్‌పై ఎప్పుడూ బ్లాక్ చేయదు. ఈ ఈవెంట్ రోమ్‌తో పాటు అదే లావాదేవీలో ట్రాన్సాక్షనల్ ఔట్‌బాక్స్‌కు వ్రాయబడుతుంది, కాబట్టి దాని ప్రొవిజనింగ్ అభ్యర్థించబడుతుందని హామీ ఇవ్వబడితేనే ఒక సైట్ ఉంటుంది.

SDKలు, ఒక CLI మరియు ఒక టెర్రాఫామ్ ప్రొవైడర్

ఒకే రకమైన స్పెక్ కలిగిన ముగ్గురు వినియోగదారులు, పని చేయడానికి మూడు విభిన్న మార్గాల కోసం.

క్లయింట్ SDKలు

TypeScript, Python, PHP మరియు గో (Go) కోసం రూపొందించబడింది, మాన్యువల్ కోడ్ రాసే వరకు వేచి ఉండకుండా మీ భాషలోనే కొత్త ఎండ్‌పాయింట్ వచ్చేలా స్పెక్‌ను ఇది ట్రాక్ చేస్తుంది.

Zinnector®, CLI

WordPress సైట్‌ను స్కాఫోల్డ్ చేయండి, నోడ్ మినహా ఏదీ ఇన్‌స్టాల్ చేయకుండా దానిని స్థానికంగా రన్ చేయండి మరియు డిప్లాయ్ చేయండి. మీరు డిప్లాయ్ చేయబోయే స్లాట్‌కి వ్యతిరేకంగా Zinnector® మీ ప్రాజెక్ట్‌ను ప్రీ-ఫ్లైట్ చేస్తుంది — PHP వెర్షన్, డిస్క్, ఫైల్ కౌంట్ — మరియు పుష్ చేసిన తర్వాత కాకుండా ముందే హెచ్చరిస్తుంది. ఇది సైన్ ఇన్ చేస్తుంది, సైట్‌లను జాబితా చేస్తుంది, డిప్లాయ్ చేస్తుంది, డొమైన్‌లు మరియు DNS ని నిర్వహిస్తుంది, మెయిల్ సర్వీస్‌లను చదువుతుంది, బ్యాకప్‌లను తీసుకుంటుంది, అనుమతించబడిన WP-CLIని రన్ చేస్తుంది, లాగ్‌లను టైల్ చేస్తుంది మరియు బల్క్ ఆపరేషన్‌లను ట్రిగ్గర్ చేస్తుంది. ఉచితం, MIT-లైసెన్స్ పొందింది మరియు ఇదే పబ్లిక్ API పై నిర్మించబడింది.

టెర్రాఫార్మ్ ప్రొవైడర్

సైట్‌లు, డొమైన్‌లు, DNS రికార్డ్‌లు, మెయిల్‌బాక్స్‌లు మరియు ప్లాన్‌లను ఇన్‌ఫ్రాస్ట్రక్చర్ యాజ్ కోడ్‌గా నిర్వహించండి. terraform apply హోస్టింగ్ సౌకర్యాన్ని అందిస్తుంది, మరియు ఎవరూ రాసిపెట్టని క్లిక్‌ల పరంపర కాకుండా మీ ఎన్విరాన్‌మెంట్‌లు పునరుత్పత్తి చేయడానికి మరియు సమీక్షించడానికి వీలుగా మారతాయి.

ఇంటరాక్టివ్ సూచన

బ్రౌజర్ నుండి మీరు చదవగల మరియు కాల్ చేయగల రూపొందించిన డాక్స్, సర్వర్ అమలు చేసే ఎండ్‌పాయింట్‌లను ఖచ్చితంగా వివరిస్తాయి — ఎందుకంటే రెండూ ఒకే స్పెసిఫికేషన్ నుండి వస్తాయి.

మీ ఎండ్‌పాయింట్ డౌన్‌లో ఉన్నప్పటికీ పనిచేసే వెబ్‌హుక్‌లు

ప్లాట్‌ఫారమ్ వెనుక ఒక బలమైన ఈవెంట్ స్పైన్ ఉంది: ప్రతి స్టేట్ మార్పు డేటాబేస్ మార్పుతో అటామిక్‌గా పోస్ట్‌గ్రెస్ (Postgres)లోని ట్రాన్సాక్షనల్ ఔట్‌బాక్స్‌లో ఒక ఈవెంట్‌ను రాస్తుంది, మరియు రిలే దానిని NATS JetStreamకి పబ్లిష్ చేస్తుంది. ఈవెంట్‌లు టైప్ చేయబడి మరియు వెర్షన్ చేయబడతాయి — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending మరియు మిగతావి.

మీకు నచ్చిన వాటికి సబ్‌స్క్రైబ్ చేసుకోండి

ఒక ఎండ్‌పాయిట్‌ను WebhookSubscriptionగా నమోదు చేయండి మరియు అది స్వీకరించే ఈవెంట్ రకాలను ఎంచుకోండి. ఒకే స్ట్రీమ్ నోటిఫికేషన్‌లు, అనలిటిక్స్, ఆటోమేషన్‌లు మరియు మీ ఇంటిగ్రేషన్‌కు సమానంగా ఫీడ్ చేస్తుంది — మేము ఉపయోగించే అదే ఈవెంట్‌లను మీరు కూడా వినియోగిస్తున్నారు.

HMACతో సంతకం చేయబడింది

ప్రతి డెలివరీ HMAC-సంతకం చేయబడి ఉంటుంది కాబట్టి మీరు దానిపై చర్య తీసుకునే ముందు అది మా నుండి వచ్చిందని నిర్ధారించుకోవచ్చు.

బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించబడింది మరియు లాగ్ చేయబడింది

విఫలమైన డెలివరీలు బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించబడతాయి మరియు ప్రతి ప్రయత్నం WebhookDelivery వలె రికార్డ్ చేయబడుతుంది. మేము ఏమి పంపామని అడుగుతూ సపోర్ట్‌కు ఈమెయిల్ పంపే బదులు, మీరు డెలివరీలను డాష్‌బోర్డ్ నుండి పరిశీలించవచ్చు మరియు రీప్లే చేయవచ్చు.

కనీసం ఒకసారైనా, కాబట్టి id పై డిడ్యూప్ చేయండి

ఈ పైప్‌లైన్ ఖచ్చితంగా-ఒక్కసారి (exactly-once) అని నటించే బదులు ఉద్దేశపూర్వకంగా కనీసం-ఒక్కసారైనా (at-least-once) పనిచేసేలా రూపొందించబడింది. ప్రచురిస్తున్న సమయంలో మధ్యలో ఆగిపోయిన రిలే యొక్క క్లెయిమ్ లీజు గడువు ముగుస్తుంది మరియు దాని ఈవెంట్‌లు మళ్లీ ప్రచురించబడతాయి. ఎన్వలప్ ఐడీపై డూప్లికేట్ తొలగింపు (dedupe) చేయండి, తద్వారా మీ కన్స్యూమర్ సరైన నిర్మాణం కలిగి ఉంటుంది.

సైట్‌లోకి కోడ్‌ను జోడించడం

ఒక API అనేది డెవలపర్ కథనంలో సగం మాత్రమే. మిగతా సగం లాంఛ్ చేయడం.

  • కాన్ఫిగ్ ఫైల్‌లో కాకుండా క్రెడెన్షియల్ స్టోర్‌లో డిప్లాయ్ కీలను ఉంచి, OAuth ద్వారా GitHub, GitLab లేదా Bitbucketని కనెక్ట్ చేయండి.
  • పుష్ అనేది బిల్డ్-అండ్-డిప్లాయ్ పైప్‌లైన్‌ను ట్రిగర్ చేస్తుంది, ఇందులో బ్రాంచ్-నుండి-ఎన్విరాన్‌మెంట్ మ్యాపింగ్ (మెయిన్ నుండి ప్రొడక్షన్, స్టేజింగ్ నుండి స్టేజింగ్) మరియు కంపోజర్ అలాగే npm కోసం ప్రతి-స్టాక్ బిల్డ్ దశలు ఉంటాయి.
  • డిప్లాయ్ విఫలమైనప్పుడు మునుపటి విడుదలకు రోల్ బ్యాక్ చేయండి.
  • స్టేజింగ్ క్లోన్ మరియు పుష్-టు-లైవ్, కాబట్టి సందర్శకులను చేరే ముందు మార్పు నిజమైన చోట పరీక్షించబడుతుంది.
  • CageFS ఐసోలేషన్ కింద ప్రతి సైట్‌కు జైల్డ్ SSH, SFTP మరియు FTP ఉంటాయి, తద్వారా ప్రతి టెనెంట్ వారి స్వంత ఫైళ్లను మాత్రమే చూస్తారు.
  • ప్యానెల్ టెర్మినల్ మరియు SSH ద్వారా wp-cli.
  • code-server ద్వారా బ్రౌజర్‌లో VS Code — ఎక్స్‌టెన్షన్‌లు, ఇంటిగ్రేటెడ్ టెర్మినల్ మరియు గిట్ (git)తో కూడిన పూర్తి ఎడిటర్, ఇది సైట్ యొక్క ఫైల్‌లను నేరుగా ఎడిట్ చేస్తుంది.
  • సైట్ వారీగా PHP వెర్షన్, సవరించదగిన PHP సెట్టింగ్‌లు, సైట్ వారీగా ఎక్స్‌టెన్షన్‌లు, ఎన్విరాన్‌మెంట్ వేరియబుల్స్ మరియు WP-క్రాన్‌తో పాటు అసలైన క్రాన్.

Four ways to work on a site

The API is one door. These are the other four, and every one of them is included with the plan rather than sold as a developer tier.

The web editor

VS Code in the browser, opened from the site's page in the dashboard, editing that site's real files with git built in and the whole editor inside the same CageFS jail as your SFTP access. It edits the LIVE site — there is no staging copy in between, so a file you save is public the moment it is written.

Zinnector®, the CLI

Free, MIT-licensed and built on this same public API. Scaffold a WordPress site, run it on your own machine, pre-flight it against the slot you are about to deploy to — PHP version, disk, file count — and deploy. Needs Node 24 or newer.

The MCP server

One catalogue of tools, so the AI client you already use can work on your sites through the same API and the same permissions the dashboard uses. The same server your own client connects to is the one wired into the web editor. Read-only until you say otherwise.

Per-site developer access

Client work does not need your password. Invite somebody by email address and they get exactly one site: they sign in as themselves, with a viewer, editor or manager role, and every other site answers 404 before any handler runs — a Postgres row-level security policy and a request-level fence, not one check. The account owner grants it and revokes it in one click, effective on their next request.

అదే APIని మీ AI ఏజెంట్ కూడా ఉపయోగించగలదు

మేము ఈ ప్లాట్‌ఫారమ్‌ను హోస్ట్ చేసిన MCP సర్వర్‌గా అందిస్తాము: ఇది ఇంజిన్ API పై ఒక సన్నని ప్రోటోకాల్ అడాప్టర్, ఇది ఒకేలా ఉండే యాక్షన్ కేటలాగ్, RBAC మరియు ఆడిట్ ట్రైల్‌ను మళ్లీ ఉపయోగిస్తుంది. Claude Code, Cursor, ChatGPT, Claude Desktop లేదా ఏదైనా MCP-సహాయక క్లయింట్‌ను ఒకసారి కనెక్ట్ చేయండి, మరియు మేము APIకి జోడించే ప్రతి ఫీచర్ దానికి స్వయంచాలకంగా అందుబాటులోకి వస్తుంది.

ఏజెంట్‌కి మూడు విషయాలు లభిస్తాయి: టూల్స్ (అవే API ఎండ్‌పాయింట్లు, డ్రిఫ్ట్ కావడానికి సమాంతర లాజిక్ ఉండదు), రిసోర్సెస్ (చూడటానికి మాత్రమే వీలైన సైట్ ఆరోగ్యం, కాన్ఫిగర్, ఇటీవలి లాగ్‌లు, మెట్రిక్స్, అప్‌టైమ్ మరియు KB కథనాలు, కాబట్టి ఇది చర్య తీసుకునే ముందు నిజమైన డేటాతో నిర్ధారణ చేస్తుంది) మరియు ప్రాంప్ట్స్ (ప్రచురించబడిన వర్క్‌ఫ్లో టెంప్లేట్‌లైన "ఈ సైట్‌ను నిర్ధారించు" లేదా "వలసను సిద్ధం చేయి").

భద్రత అనేది ప్రమాణీకరణ లాంటిదే: OAuth 2.1, మీ ఆర్గనైజేషన్‌కు బద్ధం చేయబడిన టోకెన్‌లు మరియు రోమన్-స్థాయి భద్రతతో కూడిన RBAC అనుమతులు, ప్రతి టూల్‌కు పరిమితం చేయబడినవి మరియు రద్దు చేయగలవి, ప్రొడక్షన్ నుండి వేరు చేయబడిన శాండ్‌బాక్స్. డిస్ట్రక్టివ్ చర్యలు — తొలగించడం, సస్పెండ్ చేయడం, బిల్లింగ్, భారీ ఖర్చు — స్పష్టమైన నిర్ధారణ లేదా హ్యూమన్-అప్రూవల్ పాలసీని కోరుతాయి. రేట్ పరిమితులు మరియు ఖర్చు పరిమితులు AI-ప్రేరేపిత పెయిడ్ చర్యలను నియంత్రిస్తాయి, మరియు ప్రతి MCP కాల్ గుర్తింపు, టూల్, ఆర్గ్యుమెంట్‌లు మరియు ఫలితంతో ఆడిట్-లాగ్ చేయబడుతుంది.

మేము ప్రతి యాప్‌ను ఒక్కొక్కటిగా ఇంటిగ్రేట్ చేసే బదులు ప్రొటోకాల్‌కు మద్దతు ఇస్తాము. అంటే మీ హోస్టింగ్ ఇంటిగ్రేషన్ మారకుండానే మీరు మీ AI టూలింగ్‌ను మార్చుకోవచ్చు.

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

పబ్లిక్ API మరియు డ్యాష్‌బోర్డ్ ఉపయోగించేది ఒక్కటేనా?

అవును — ఇది అదే ఇంజిన్ API, ప్రచురించబడింది మరియు పటిష్టం చేయబడింది. డాష్‌బోర్డ్, అడ్మిన్ కన్సోల్, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, MCP సర్వర్ మరియు వెబ్‌హుక్‌లు అన్నీ ఒకే ఉపరితలాన్ని వినియోగించుకుంటాయి, అందుకే API ప్యానెల్ కంటే వెనుకబడి ఉండదు.

డబ్బు ఖర్చు చేయకుండా లేదా అసలైన సర్వర్‌లను సృష్టించకుండా నేను ఇంటిగ్రేషన్‌ను పరీక్షించగలనా?

అవును. శాండ్‌బాక్స్ కీలు ప్రొడక్షన్ కీలకు భిన్నంగా వేర్వేరుగా జారీ చేయబడతాయి మరియు పరీక్షా మోడ్‌లో రన్ అవుతాయి: వాస్తవ బిల్లింగ్ మరియు వాస్తవ ప్రొవిజనింగ్ ఉండవు. మీ CIని శాండ్‌బాక్స్ ఆధారాలతో అనుసంధానించండి మరియు అభ్యర్థన, ప్రతిస్పందన చక్రం మొత్తాన్ని సురక్షితంగా పరీక్షించండి.

పునఃప్రయత్నం (రైట్రై) వల్ల ఒకే వస్తువు రెండుసార్లు సృష్టించబడకుండా నేను ఎలా ఆపగలను?

మీ POST పై ఒక Idempotency-Keyని పంపండి. రిప్లే రికార్డ్ ఇన్‌లైన్‌కు బదులుగా కమిట్ సమయంలో వ్రాయబడుతుంది, కాబట్టి వాస్తవంగా కమిట్ కాని వరుస కోసం రిట్రై ఎప్పటికీ కాష్ చేయబడిన సక్సెస్‌ను రిప్లే చేయదు, మరియు విఫలమైన అభ్యర్థన దాని లాక్‌ను వెంటనే విడుదల చేస్తుంది, తద్వారా మీ సరిదిద్దబడిన రిట్రై ఆగిపోదు. వెబ్‌హుక్ డెలివరీ అనేది డిజైన్ ద్వారా కనీసం ఒక్కసారైనా జరుగుతుంది — మీ వైపు ఎన్వెలప్ ఐడిపై డీడ్యూప్ చేయండి.

నేను నా అన్ని క్లయింట్ సంస్థలకు ఒకే API కీకి ప్రాప్యతను ఇవ్వగలనా?

ఈరోజు కాదు. API కీలు ప్రతి సంస్థకు జారీ చేయబడతాయి, కాబట్టి అనేక క్లైంట్ ఆర్గ్‌లను విస్తరించే ఇంటిగ్రేషన్ ప్రతిదానికీ ఒక కీని కలిగి ఉంటుంది. యూజర్ ప్రిన్సిపాల్స్ కోసం అనుమతులు కూడా ప్రతి సంస్థ ఆధారంగా తనిఖీ చేయబడతాయి: ఒక ఆర్గ్‌లో sites.create కలిగి ఉండటం వేరే, సంబంధం లేని ఆర్గ్‌లో ఎలాంటి యాక్సెస్‌ను ఇవ్వదు, అయితే ఇది దాని క్రింద ఉన్న నెస్టెడ్ ఆర్గ్‌లకు వర్తిస్తుంది. ఇది ఉద్దేశపూర్వకంగా చేయబడింది — ఇది రాజీపడిన కీని మొత్తం ప్లాట్‌ఫారమ్‌కు కాకుండా దాని స్వంత సంస్థకు మరియు దాని క్రింద ఉన్న ఉప-ఆర్గ్‌లకు పరిమితం చేస్తుంది.

బిల్ట్-ఇన్ డెవలపర్ రోల్ అసలు దేనికి అనుమతిస్తుంది?

డెవలపర్ పాత్రలో సంస్థ రీడ్, API కీ మేనేజ్‌మెంట్, సైట్‌లను చూడటం మరియు సృష్టించడం, వాటిని రీస్టార్ట్ చేయడం, వాటి క్యాచేని పర్జ్ చేయడం, అలాగే టికెట్‌లను చూడటం మరియు రిప్లై ఇవ్వడం వంటివి ఉంటాయి. ఇది బిల్లింగ్ నియంత్రణను ఉద్దేశపూర్వకంగా మినహాయిస్తుంది. డిప్లాయ్ మరియు పుష్-టు-లైవ్ అనుమతులు ఇందులో భాగం కావు అని గమనించండి — మీ టీమ్ మెంబర్‌కు అవి అవసరమైతే, డెవలపర్ అనేది అతిపెద్ద సాంకేతిక పాత్ర అని భావించకుండా, ఆ అనుమతులు ఉన్న పాత్రను కేటాయించండి.

నా ఎండ్‌పాయింట్ ఒక గంట పాటు పనిచేయకపోతే నా వెబ్‌హుక్స్ ఏమవుతాయి?

బ్యాక్‌ఆఫ్‌తో డెలివరీలు మళ్లీ ప్రయత్నించబడతాయి మరియు ప్రతి ప్రయత్నం మీరు పరిశీలించగల WebhookDelivery వలె రికార్డ్ చేయబడుతుంది. అప్‌స్ట్రీమ్‌లో, మార్పు జరిగిన అదే డేటాబేస్ ట్రాన్సాక్షన్‌లో ఈవెంట్‌లు ట్రాన్సాక్షనల్ అవుట్‌బాక్స్‌లో వ్రాయబడతాయి, కాబట్టి వినియోగదారు అందుబాటులో లేనప్పుడు ఏదీ పోగొట్టుకోదు — పని చేయని వినియోగదారు ఆలస్యం అవుతుంది కానీ ఎప్పటికీ ప్రొడ్యూసర్‌ను పాడు చేయదు, మరియు మీరు తిరిగి వచ్చిన తర్వాత డ్యాష్‌బోర్డ్ నుండి డెలివరీలను రీప్లే చేయవచ్చు.

దీనిపై నిర్మాణాన్ని ప్రారంభించడానికి ఎంత ఖర్చవుతుంది?

Footprint-Free హోస్టింగ్ యొక్క కార్డ్-రహిత 14-రోజుల ట్రయల్‌ని ప్రారంభించండి — చెల్లింపు వివరాలు అవసరం లేదు, గరిష్టంగా 5 సైట్‌లు. పెయిడ్ Footprint-Free శ్రేణులు PBN 5 కోసం $6/నెల నుండి ప్రారంభమవుతాయి. ప్రతి ప్రణాళిక 30-రోజుల మనీ-బ్యాక్ గ్యారంటీ, ఉచిత మైగ్రేషన్‌లు మరియు వెండర్ లాక్-ఇన్ లేకపోవడాన్ని కలిగి ఉంటుంది.

స్పెక్ ని చదవండి, ఆపై దాని ఆధారంగా బిల్డ్ చేయండి

ప్రపంచవ్యాప్తంగా 650,000+ సైట్‌ల కోసం మేము రూపొందించిన హోస్టింగ్‌లో — స్పెక్-ఫస్ట్ API, జనరేట్ చేయబడిన SDKలు, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, సైన్డ్ వెబ్‌హుక్స్ మరియు MCP సర్వర్. క్రెడిట్ కార్డ్ అవసరం లేని 14 రోజుల ఉచిత ట్రయల్‌తో ప్రారంభించండి, చెల్లింపు వివరాలు అవసరం లేదు.

ఉచితంగా ప్రారంభించండి