డెవలపర్ల కోసం
జిన్ డిజిటల్® (Zinn Digital®) అనేది ఒక API-ఫస్ట్ ప్లాట్ఫారమ్. మా డ్యాష్బోర్డ్ను నడిపించే అదే ఇంజిన్ API మీకు కూడా లభిస్తుంది — వెర్షన్తో కూడినది, స్పెక్-ఫస్ట్ మరియు బిల్డ్ సమయంలో 100% డాక్యుమెంట్ చేయబడినది, దీనిపై జనరేట్ చేయబడిన SDKలు, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, సైన్ చేయబడిన వెబ్హుక్స్ మరియు MCP సర్వర్ ఉంటాయి. మీరు పని చేయడానికిేది ఉపయోగించినా — టెర్మినల్, పైప్లైన్, స్టేట్ ఫైల్ లేదా AI ఏజెంట్ — ప్లాట్ఫారమ్ దానికి అనుగుణంగా స్పందిస్తుంది.
చాలా మంది హోస్ట్లు కంట్రోల్ ప్యానెల్పై తర్వాత APIని జోడిస్తారు, మరియు అది స్పష్టంగా కనిపిస్తుంది — ప్యానెల్ ఫీచర్లలో సగానికి పైగా ఎప్పటికీ బయటపడవు. మేము దీనికి విరుద్ధంగా నిర్మించాము. డాష్బోర్డ్, అడ్మిన్ కన్సోల్, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, MCP సర్వర్ మరియు మీ స్వంత ఇంటిగ్రేషన్లు అన్నీ ఒకే ఇంజిన్ APIని ఉపయోగిస్తాయి. మీరు దీన్ని ప్యానెల్లో చేయగలిగితే, మీరు దీన్ని కోడ్లో కూడా చేయవచ్చు.
OpenAPI స్పెసిఫికేషన్ అనేది మూల సత్యం, మరియు అది స్పెసిఫికేషన్లో ఉంటేనే తప్ప ఏ ఎండ్పాయింట్ కూడా విడుదల కాదు. ఆ ఒక్క నియమం వల్లే పబ్లిక్ API ఎవెంచ్యువల్గా కాకుండా బిల్డ్ సమయంలోనే పూర్తిగా డాక్యుమెంట్ చేయబడుతుంది — ఎందుకంటే డాక్యుమెంట్ చేయని ఎండ్పాయింట్ అనేది ఉనికిలో ఉండదు కాబట్టి, డాక్యుమెంట్ చేయని మూలంటూ ఏదీ ఉండదు.
ఇంటరాక్టివ్ రిఫరెన్స్ డాక్స్, నాలుగు క్లైంట్ SDKలు, CLIలో ఎక్కువ భాగం మరియు టెర్రాఫార్మ్ ప్రొవైడర్ స్కాఫోల్డింగ్ అన్నీ ఆ ఒక్క స్పెసిఫికేషన్ నుండే జనరేట్ చేయబడతాయి. ఒకే సోర్స్, అనేక ఆర్టిఫాక్ట్లు, ఎల్లప్పుడూ సింక్లో ఉంటాయి — మీరు ఇంప్లిమెంటేషన్ నుండి వేరుపడిన డాక్ కోసం ఎప్పటికీ వెతకాల్సిన అవసరం లేదు.
/v1 కింద ఎండ్-పాయింట్లు అందుబాటులో ఉంటాయి, వీటి కోసం ఒక ప్రచురించబడిన నిలిపివేత విధానం మరియు ఛేంజ్లాగ్ ఉంటాయి. ఫెయిల్ అయిన బిల్డ్ ద్వారా తెలుసుకునే బదులు, ఏదైనా మారే ముందు మీకు వ్రాతపూర్వకంగా తెలియజేయబడుతుంది.
అమలు-మరియు-స్పెసిఫికేషన్ కాంట్రాక్ట్ పరీక్షలు మరియు OpenAPI లింటింగ్ ప్రతి మార్పుపై రన్ అవుతాయి. కోడ్ మరియు కాంట్రాక్ట్ మధ్య తేడా (డ్రిఫ్ట్) బిల్డ్ను ఫెయిల్ చేస్తుంది — కాబట్టి మీరు మీ క్లైంట్ను జనరేట్ చేసే స్పెసిఫికేషన్ సర్వర్ వాస్తవంగా గౌరవించే స్పెసిఫికేషన్ అవుతుంది.
లోపలికి వెళ్లడానికి రెండు మార్గాలు, వాటి వెనుక ఉన్న ఒకే ఒక సూత్రం. మీరు ఏది ఉపయోగించినా, అదే అనుమతి తనిఖీలు మరియు అదే డేటాబేస్-స్థాయి ఐసోలేషన్ వర్తిస్తాయి.
కీలు zdk_<mode>_<prefix>_<secret> వలె కనిపిస్తాయి. రహస్య పదానికి సంబంధించిన SHA-256 హ్యాష్ మాత్రమే నిల్వ చేయబడుతుంది — కీ జారీ చేసిన తర్వాత దాన్ని మేము మళ్లీ చూపలేము, మా డేటాబేస్ను చేరుకునే ఎవరూ కూడా దాన్ని చూపలేరు. కీలు స్కోప్లను కలిగి ఉంటాయి, రద్దు చేయబడతాయి మరియు ప్రతి వ్యక్తికి బదులుగా ప్రతి సంస్థకు జారీ చేయబడతాయి.
శాన్బాక్స్ కీలు ప్రొడక్షన్ కీలకు భిన్నంగా ఉంటాయి మరియు శాన్బాక్స్ మోడ్లో రన్ అవుతాయి: నిజమైన బిల్లింగ్ ఉండదు, నిజమైన ప్రొవిజనింగ్ ఉండదు. మీ ఇంటిగ్రేషన్ టెస్ట్లు డబ్బు ఖర్చు చేయకుండా లేదా సర్వర్లను బిల్డ్ చేయకుండా APIని పూర్తిగా ఉపయోగించుకోవచ్చు.
Keycloak జారీ చేసిన JWT లతో యూజర్ సెషన్లు ప్రమాణీకరించబడతాయి, ఇవి రీలమ్ పబ్లిక్ కీతో సరిచూడబడతాయి మరియు API కీ ఏ Principal ఆబ్జెక్ట్ను పొందుతుందో అదే ఆబ్జెక్ట్ను పొందుతాయి. ఎండ్పాయింట్లు sites.create లేదా apikeys.manage వంటి నిర్దిష్ట అనుమతి కీలపై ఆధారపడి నియంత్రించబడతాయి, ఇవి ప్రతి సంస్థకు వేరువేరుగా తనిఖీ చేయబడతాయి — ఒక సంస్థలోని అనుమతి మరొక సంబంధం లేని సంస్థలో ఎటువంటి యాక్సెస్ను మంజూరు చేయదు, అయితే ఇది దాని కింద ఉన్న సంస్థలకు వర్తిస్తుంది.
ప్రతి టెనెంట్ అభ్యర్థన ప్రిన్సిపాల్ నుండి సెట్ చేయబడిన పోస్ట్గ్రేస్ ఆర్గ్ స్కోప్తో కూడిన ట్రాన్సాక్షన్లో రన్ అవుతుంది, కాబట్టి ఐసోలేషన్ డేటాబేస్ ద్వారా అమలు చేయబడుతుంది, ఎవరైనా మరచిపోయే ORM ఫిల్టర్ ద్వారా కాదు. క్వెరీసెట్ ఫిల్టర్ ఇంకా లోతైన రక్షణగా ఉంది.
READMEలో చూడటానికి ఒక APIని అందంగా తీర్చిదిద్దడం సులభం, కానీ నిజమైన ట్రాఫిక్ కింద అది సరిగ్గా పనిచేసేలా చేయడం కష్టం. తెల్లవారుజామున మూడింటికి ఇంటిగ్రేషన్లు విఫలమయ్యే భాగాలు అవే కాబట్టి, మేము వాటిపైనే ప్రత్యేకంగా శ్రమించాము.
ఈ వివరాలను ప్రత్యేకంగా ప్రస్తావించడం ముఖ్యం, ఎందుకంటే ఇది బల్క్ వర్క్ ప్రవర్తనను ప్రభావితం చేస్తుంది: డూప్లికేట్ డొమైన్పై వచ్చే 409 ఏదైనా టెనెంట్ కోసం "ఈ హోస్ట్నేమ్ ఇక్కడ హోస్ట్ చేయబడిందా?" అని సమాధానం ఇస్తుంది, ఇది ఒక ఎన్యుమరేషన్ ఒరాకిల్ మరియు Footprint-Freeకి వ్యతిరేకంగా నిజమైన డీ-అనామినిజేషన్ రిస్క్. సైట్ సృష్టిని నిరోధించడం అనేది సులభమైన పరిష్కారంగా ఉండేది మరియు అది బల్క్-ప్రొవిజనింగ్ ఉత్పత్తిని పూర్తిగా దెబ్బతీసేది. దీనికి బదులుగా తిరస్కరించబడిన డూప్లికేట్-డొమైన్ ప్రయత్నాలకు మాత్రమే ప్రతి ప్రిన్సిపాల్ వారీగా బడ్జెట్ కేటాయించబడుతుంది. విజయవంతమైన క్రియేషన్లకు ఎప్పుడూ ఛార్జ్ చేయబడవు - కాబట్టి మీరు రోజంతా బల్క్లో ప్రొవిజన్ చేయవచ్చు, మరియు ప్రోబింగ్ దాదాపు వెంటనే నిలిచిపోతుంది.
ఒకే రకమైన స్పెక్ కలిగిన ముగ్గురు వినియోగదారులు, పని చేయడానికి మూడు విభిన్న మార్గాల కోసం.
TypeScript, Python, PHP మరియు గో (Go) కోసం రూపొందించబడింది, మాన్యువల్ కోడ్ రాసే వరకు వేచి ఉండకుండా మీ భాషలోనే కొత్త ఎండ్పాయింట్ వచ్చేలా స్పెక్ను ఇది ట్రాక్ చేస్తుంది.
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-సంతకం చేయబడి ఉంటుంది కాబట్టి మీరు దానిపై చర్య తీసుకునే ముందు అది మా నుండి వచ్చిందని నిర్ధారించుకోవచ్చు.
విఫలమైన డెలివరీలు బ్యాక్ఆఫ్తో మళ్లీ ప్రయత్నించబడతాయి మరియు ప్రతి ప్రయత్నం WebhookDelivery వలె రికార్డ్ చేయబడుతుంది. మేము ఏమి పంపామని అడుగుతూ సపోర్ట్కు ఈమెయిల్ పంపే బదులు, మీరు డెలివరీలను డాష్బోర్డ్ నుండి పరిశీలించవచ్చు మరియు రీప్లే చేయవచ్చు.
ఈ పైప్లైన్ ఖచ్చితంగా-ఒక్కసారి (exactly-once) అని నటించే బదులు ఉద్దేశపూర్వకంగా కనీసం-ఒక్కసారైనా (at-least-once) పనిచేసేలా రూపొందించబడింది. ప్రచురిస్తున్న సమయంలో మధ్యలో ఆగిపోయిన రిలే యొక్క క్లెయిమ్ లీజు గడువు ముగుస్తుంది మరియు దాని ఈవెంట్లు మళ్లీ ప్రచురించబడతాయి. ఎన్వలప్ ఐడీపై డూప్లికేట్ తొలగింపు (dedupe) చేయండి, తద్వారా మీ కన్స్యూమర్ సరైన నిర్మాణం కలిగి ఉంటుంది.
ఒక API అనేది డెవలపర్ కథనంలో సగం మాత్రమే. మిగతా సగం లాంఛ్ చేయడం.
మేము ఈ ప్లాట్ఫారమ్ను హోస్ట్ చేసిన MCP సర్వర్గా అందిస్తాము: ఇది ఇంజిన్ API పై ఒక సన్నని ప్రోటోకాల్ అడాప్టర్, ఇది ఒకేలా ఉండే యాక్షన్ కేటలాగ్, RBAC మరియు ఆడిట్ ట్రైల్ను మళ్లీ ఉపయోగిస్తుంది. Claude Code, Cursor, ChatGPT, Claude Desktop లేదా ఏదైనా MCP-సహాయక క్లయింట్ను ఒకసారి కనెక్ట్ చేయండి, మరియు మేము APIకి జోడించే ప్రతి ఫీచర్ దానికి స్వయంచాలకంగా అందుబాటులోకి వస్తుంది.
ఏజెంట్కి మూడు విషయాలు లభిస్తాయి: టూల్స్ (అవే API ఎండ్పాయింట్లు, డ్రిఫ్ట్ కావడానికి సమాంతర లాజిక్ ఉండదు), రిసోర్సెస్ (చూడటానికి మాత్రమే వీలైన సైట్ ఆరోగ్యం, కాన్ఫిగర్, ఇటీవలి లాగ్లు, మెట్రిక్స్, అప్టైమ్ మరియు KB కథనాలు, కాబట్టి ఇది చర్య తీసుకునే ముందు నిజమైన డేటాతో నిర్ధారణ చేస్తుంది) మరియు ప్రాంప్ట్స్ (ప్రచురించబడిన వర్క్ఫ్లో టెంప్లేట్లైన "ఈ సైట్ను నిర్ధారించు" లేదా "వలసను సిద్ధం చేయి").
భద్రత అనేది ప్రమాణీకరణ లాంటిదే: OAuth 2.1, మీ ఆర్గనైజేషన్కు బద్ధం చేయబడిన టోకెన్లు మరియు రోమన్-స్థాయి భద్రతతో కూడిన RBAC అనుమతులు, ప్రతి టూల్కు పరిమితం చేయబడినవి మరియు రద్దు చేయగలవి, ప్రొడక్షన్ నుండి వేరు చేయబడిన శాండ్బాక్స్. డిస్ట్రక్టివ్ చర్యలు — తొలగించడం, సస్పెండ్ చేయడం, బిల్లింగ్, భారీ ఖర్చు — స్పష్టమైన నిర్ధారణ లేదా హ్యూమన్-అప్రూవల్ పాలసీని కోరుతాయి. రేట్ పరిమితులు మరియు ఖర్చు పరిమితులు AI-ప్రేరేపిత పెయిడ్ చర్యలను నియంత్రిస్తాయి, మరియు ప్రతి MCP కాల్ గుర్తింపు, టూల్, ఆర్గ్యుమెంట్లు మరియు ఫలితంతో ఆడిట్-లాగ్ చేయబడుతుంది.
మేము ప్రతి యాప్ను ఒక్కొక్కటిగా ఇంటిగ్రేట్ చేసే బదులు ప్రొటోకాల్కు మద్దతు ఇస్తాము. అంటే మీ హోస్టింగ్ ఇంటిగ్రేషన్ మారకుండానే మీరు మీ AI టూలింగ్ను మార్చుకోవచ్చు.
అవును — ఇది అదే ఇంజిన్ API, ప్రచురించబడింది మరియు పటిష్టం చేయబడింది. డాష్బోర్డ్, అడ్మిన్ కన్సోల్, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, MCP సర్వర్ మరియు వెబ్హుక్లు అన్నీ ఒకే ఉపరితలాన్ని వినియోగించుకుంటాయి, అందుకే API ప్యానెల్ కంటే వెనుకబడి ఉండదు.
అవును. శాండ్బాక్స్ కీలు ప్రొడక్షన్ కీలకు భిన్నంగా వేర్వేరుగా జారీ చేయబడతాయి మరియు పరీక్షా మోడ్లో రన్ అవుతాయి: వాస్తవ బిల్లింగ్ మరియు వాస్తవ ప్రొవిజనింగ్ ఉండవు. మీ CIని శాండ్బాక్స్ ఆధారాలతో అనుసంధానించండి మరియు అభ్యర్థన, ప్రతిస్పందన చక్రం మొత్తాన్ని సురక్షితంగా పరీక్షించండి.
మీ POST పై ఒక Idempotency-Keyని పంపండి. రిప్లే రికార్డ్ ఇన్లైన్కు బదులుగా కమిట్ సమయంలో వ్రాయబడుతుంది, కాబట్టి వాస్తవంగా కమిట్ కాని వరుస కోసం రిట్రై ఎప్పటికీ కాష్ చేయబడిన సక్సెస్ను రిప్లే చేయదు, మరియు విఫలమైన అభ్యర్థన దాని లాక్ను వెంటనే విడుదల చేస్తుంది, తద్వారా మీ సరిదిద్దబడిన రిట్రై ఆగిపోదు. వెబ్హుక్ డెలివరీ అనేది డిజైన్ ద్వారా కనీసం ఒక్కసారైనా జరుగుతుంది — మీ వైపు ఎన్వెలప్ ఐడిపై డీడ్యూప్ చేయండి.
ఈరోజు కాదు. API కీలు ప్రతి సంస్థకు జారీ చేయబడతాయి, కాబట్టి అనేక క్లైంట్ ఆర్గ్లను విస్తరించే ఇంటిగ్రేషన్ ప్రతిదానికీ ఒక కీని కలిగి ఉంటుంది. యూజర్ ప్రిన్సిపాల్స్ కోసం అనుమతులు కూడా ప్రతి సంస్థ ఆధారంగా తనిఖీ చేయబడతాయి: ఒక ఆర్గ్లో sites.create కలిగి ఉండటం వేరే, సంబంధం లేని ఆర్గ్లో ఎలాంటి యాక్సెస్ను ఇవ్వదు, అయితే ఇది దాని క్రింద ఉన్న నెస్టెడ్ ఆర్గ్లకు వర్తిస్తుంది. ఇది ఉద్దేశపూర్వకంగా చేయబడింది — ఇది రాజీపడిన కీని మొత్తం ప్లాట్ఫారమ్కు కాకుండా దాని స్వంత సంస్థకు మరియు దాని క్రింద ఉన్న ఉప-ఆర్గ్లకు పరిమితం చేస్తుంది.
డెవలపర్ పాత్రలో సంస్థ రీడ్, API కీ మేనేజ్మెంట్, సైట్లను చూడటం మరియు సృష్టించడం, వాటిని రీస్టార్ట్ చేయడం, వాటి క్యాచేని పర్జ్ చేయడం, అలాగే టికెట్లను చూడటం మరియు రిప్లై ఇవ్వడం వంటివి ఉంటాయి. ఇది బిల్లింగ్ నియంత్రణను ఉద్దేశపూర్వకంగా మినహాయిస్తుంది. డిప్లాయ్ మరియు పుష్-టు-లైవ్ అనుమతులు ఇందులో భాగం కావు అని గమనించండి — మీ టీమ్ మెంబర్కు అవి అవసరమైతే, డెవలపర్ అనేది అతిపెద్ద సాంకేతిక పాత్ర అని భావించకుండా, ఆ అనుమతులు ఉన్న పాత్రను కేటాయించండి.
బ్యాక్ఆఫ్తో డెలివరీలు మళ్లీ ప్రయత్నించబడతాయి మరియు ప్రతి ప్రయత్నం మీరు పరిశీలించగల WebhookDelivery వలె రికార్డ్ చేయబడుతుంది. అప్స్ట్రీమ్లో, మార్పు జరిగిన అదే డేటాబేస్ ట్రాన్సాక్షన్లో ఈవెంట్లు ట్రాన్సాక్షనల్ అవుట్బాక్స్లో వ్రాయబడతాయి, కాబట్టి వినియోగదారు అందుబాటులో లేనప్పుడు ఏదీ పోగొట్టుకోదు — పని చేయని వినియోగదారు ఆలస్యం అవుతుంది కానీ ఎప్పటికీ ప్రొడ్యూసర్ను పాడు చేయదు, మరియు మీరు తిరిగి వచ్చిన తర్వాత డ్యాష్బోర్డ్ నుండి డెలివరీలను రీప్లే చేయవచ్చు.
Footprint-Free హోస్టింగ్ యొక్క కార్డ్-రహిత 14-రోజుల ట్రయల్ని ప్రారంభించండి — చెల్లింపు వివరాలు అవసరం లేదు, గరిష్టంగా 5 సైట్లు. పెయిడ్ Footprint-Free శ్రేణులు PBN 5 కోసం $6/నెల నుండి ప్రారంభమవుతాయి. ప్రతి ప్రణాళిక 30-రోజుల మనీ-బ్యాక్ గ్యారంటీ, ఉచిత మైగ్రేషన్లు మరియు వెండర్ లాక్-ఇన్ లేకపోవడాన్ని కలిగి ఉంటుంది.
ప్రపంచవ్యాప్తంగా 650,000+ సైట్ల కోసం మేము రూపొందించిన హోస్టింగ్లో — స్పెక్-ఫస్ట్ API, జనరేట్ చేయబడిన SDKలు, CLI, టెర్రాఫార్మ్ ప్రొవైడర్, సైన్డ్ వెబ్హుక్స్ మరియు MCP సర్వర్. క్రెడిట్ కార్డ్ అవసరం లేని 14 రోజుల ఉచిత ట్రయల్తో ప్రారంభించండి, చెల్లింపు వివరాలు అవసరం లేదు.
ఉచితంగా ప్రారంభించండి