क्या संभव है — और किन नियमों के अनुसार
API के ज़रिए आप वह सब बनाते, बदलते और प्रकाशित करते हैं जो आप आम तौर पर टूल्स में करते हैं। वही नियम लागू होते हैं: आपके पैकेज की सीमाएँ, आपकी AI पट्टी, प्रकाशित करने से पहले एक पूर्ण ब्रांड, बिना अंतराल वाले इनवॉइस नंबर और हर अपलोड की गई इमेज की जाँच। जो टूल में संभव नहीं है, वह यहाँ भी संभव नहीं है।
अगर कुछ अस्वीकार होता है, तो type में एक निश्चित अंग्रेज़ी पहचान होती है, जिसके आधार पर आपका प्रोग्राम निर्णय लेता है — जैसे plan_limit_reached, brand_incomplete या ai_quota_exhausted — और detail में वह वाक्य होता है जो टूल भी आपको दिखाता।
{
"error": {
"type": "brand_incomplete",
"message": "The brand needs a name, an address and an email or phone number before anything is published.",
"detail": "Bevor diese Website online geht, muss klar sein, wer dahintersteht. Es fehlt: …"
}
}अधिकार
हर क्षेत्र में पढ़ने का एक अधिकार और लिखने का एक अधिकार होता है: वेबसाइटों के लिए sites:read और sites:write, डोमेन और DNS एंट्री के लिए domains:read और dns:write, ग्राहकों, इनवॉइस और कोटेशन के लिए invoices:read और invoices:write, MediaStudio के लिए media:read और media:write, आपके ब्रांडों के लिए brand:read। कुंजी बनाते समय इन्हें “यह कुंजी क्या कर सकती है?” के अंतर्गत चुनें।
वेबसाइटें
POST /v1/sites एक वाक्य से पूरी वेबसाइट बनाता है — ड्राफ़्ट के रूप में। इसमें आमतौर पर 20 से 60 सेकंड लगते हैं और AI बैलेंस खर्च होता है, जैसे WebSiteBuilder में। POST /v1/sites/{id}/edit आपके निर्देश के अनुसार ड्राफ़्ट का एक पेज बदलता है। कोई भी चीज़ केवल POST /v1/sites/{id}/publish से ही ऑनलाइन होती है; POST /v1/sites/{id}/unpublish बिना कुछ खोए वेबसाइट को फिर से ऑफ़लाइन कर देता है।
brand_id उस ब्रांड को बताता है, जिसका लोगो और कंपनी विवरण वेबसाइट दिखाती है। अगर आपके पास केवल एक ब्रांड है, तो हर वेबसाइट अपने आप उसी का अनुसरण करती है — तब वहाँ उसका नंबर होता है और brand_assigned false होता है। कई ब्रांड होने पर कोई वेबसाइट केवल उसी ब्रांड का लोगो और कंपनी विवरण दिखाती है, जिसे आपने उसे असाइन किया है; असाइनमेंट के बिना brand_id null होता है।
curl https://api.kenjtec.com/v1/sites \
-H "Authorization: Bearer kt_api_…" \
-H "Idempotency-Key: cafe-lumen-2026-10" \
-H "Content-Type: application/json" \
-d '{"brief": "Café Lumen in Lissabon: Frühstück, eigene Kaffeebohnen, Tische zum Reservieren."}'AI एंडपॉइंट के साथ एक Idempotency-Key भेजें। अगर कनेक्शन टूट जाए, तो उसी कुंजी के साथ दोबारा कोशिश करें और आपको पहले से बनी वेबसाइट मिल जाएगी — दूसरी बार भुगतान किए बिना।
DNS एंट्री
GET /v1/domains आपके वे डोमेन दिखाता है, जिनका DNS KENJTEC के पास है। उनके अंतर्गत आप एंट्री बनाते हैं (A, AAAA, CNAME, MX, TXT, NS), उन्हें PATCH से बदलते हैं और हटाते हैं — उन्हीं जाँचों के साथ जो DomainStudio में होती हैं।
जो एंट्री KENJTEC ने आपके किसी काम के लिए सेट की हैं, उनमें managed: true होता है। API इन्हें नहीं बदलती; यह DomainStudio में होता है, जहाँ इसके परिणाम साथ में दिखाए जाते हैं।
इनवॉइस और कोटेशन
POST /v1/customers एक ग्राहक बनाता है, POST /v1/invoices एक ड्राफ़्ट — इनवॉइस या कोटेशन। योग की गणना KENJTEC करता है; आप हर पंक्ति के लिए मात्रा, सेंट में इकाई मूल्य और टैक्स दर भेजते हैं।
POST /v1/invoices/{id}/issue इसे जारी करता है: दस्तावेज़ को बिना अंतराल के अगला नंबर मिलता है और उसके बाद वह स्थिर हो जाता है। सुधार करने का मतलब है रद्द करना — POST /v1/invoices/{id}/cancel अपने अलग नंबर के साथ एक रद्दीकरण इनवॉइस बनाता है। कुछ भी हटाया नहीं जाता।
मीडिया अपलोड करना
अपलोड दो चरणों में होता है, जैसे MediaStudio में। POST /v1/media/uploads आपको एक पता और हेडर देता है; वहाँ आप फ़ाइल PUT के साथ भेजते हैं। इसके बाद POST /v1/media/{id}/confirm जाँचता है कि क्या पहुँचा है, और उसके बाद ही फ़ाइल अपने पते पर उपलब्ध होती है।
JPEG, PNG, WebP, GIF, PDF, MP4 और WebM की अनुमति है। जो इमेज कंटेंट जाँच में पास नहीं होती, उसे 422 के साथ अस्वीकार कर दिया जाता है।
अपना ब्रांड पढ़ना
GET /v1/brands आपके ब्रांड BrandStudio से लौटाता है: नाम, लोगो, रंग, फ़ॉन्ट, कंपनी विवरण और चैनल। इस तरह आपके अपने प्रोग्राम उसी रूप-रंग में बनाते हैं जिसमें आपके KENJTEC काम हैं।