शुरुआत: API कुंजी और पहला कॉल.

API क्या कर सकती है

KENJTEC API आपके अपने प्रोग्रामों को आपके खाते तक पहुँच देती है: फ़ॉर्म और उनके उत्तर, शॉप और ऑर्डर पढ़ना — और लिखना: वेबसाइटें बनाना और प्रकाशित करना, DNS प्रविष्टियाँ प्रबंधित करना, इनवॉइस बनाना, मीडिया अपलोड करना। इसके साथ वेबहुक भी हैं — जैसे ही कुछ होता है, हम आपके सर्वर को सूचित करते हैं। और आपकी अपनी AI उसी कुंजी के साथ MCP के माध्यम से काम कर सकती है।

पता यह है: https://api.kenjtec.com/v1. API हर सशुल्क पैकेज में शामिल है, बिना किसी अतिरिक्त शुल्क के।

कुंजी बनाना

हर प्रोग्राम अपनी अलग API कुंजी से साइन इन करता है। एक कुंजी के साथ अधिकार जुड़े होते हैं: forms:read फ़ॉर्म और उत्तर पढ़ता है, orders:read शॉप और ऑर्डर पढ़ता है, webhooks:manage वेबहुक बनाता और हटाता है। लिखने वाले एंडपॉइंट के लिए हर क्षेत्र के अपने अलग अधिकार हैं। हर प्रोग्राम को उसकी अपनी कुंजी दें — तब आप किसी एक कुंजी को बाकी कुंजियों को प्रभावित किए बिना रद्द कर सकते हैं।

1. 1डैशबोर्ड खोलें और “सेटिंग्स” के अंतर्गत डेवलपर क्षेत्र चुनें।
2. 2“API कुंजियाँ” के अंतर्गत कुंजी को एक नाम दें, उदाहरण के लिए “स्टॉक मिलान”।
3. 3“यह कुंजी क्या कर सकती है?” के अंतर्गत केवल वही अधिकार चुनें जिनकी प्रोग्राम को ज़रूरत है।
4. 4“कुंजी बनाएँ” पर क्लिक करें और कुंजी तुरंत कॉपी करें।

कुंजी ठीक एक बार दिखाई जाती है। हम केवल एक चेकसम सहेजते हैं — यदि कुंजी खो जाए, तो उसे “रद्द करें” से रद्द करें और एक नई कुंजी बनाएँ।

पहला कॉल

हर अनुरोध में कुंजी को Authorization हेडर में भेजें। /v1/me आपको बताता है कि कुंजी किस खाते की है और उसके पास कौन-से अधिकार हैं।

curl https://api.kenjtec.com/v1/me \
  -H "Authorization: Bearer kt_api_…"

{
  "id": 1042,
  "object": "account",
  "email": "ana@deine-firma.com",
  "handle": "cafe-lumen",
  "address": "https://cafe-lumen.kenjtec.ai",
  "key": { "name": "Lager-Abgleich", "scopes": ["orders:read"] }
}

एंडपॉइंट

ये एंडपॉइंट उपलब्ध हैं। पूरा, मशीन-पठनीय विवरण https://api.kenjtec.com/openapi.json पर है — इससे किसी भी प्रोग्रामिंग भाषा के लिए प्रोग्राम लाइब्रेरी बनाई जा सकती हैं।

GET    /v1/me
GET    /v1/forms
GET    /v1/forms/{id}
GET    /v1/forms/{id}/responses
GET    /v1/forms/{id}/responses/{id}
GET    /v1/shops
GET    /v1/orders          ?shop_id=  &status=  &payment_status=
GET    /v1/orders/{id}
GET    /v1/webhooks
POST   /v1/webhooks
DELETE /v1/webhooks/{id}

GET    /v1/sites
GET    /v1/sites/{id}
POST   /v1/sites
POST   /v1/sites/{id}/edit
POST   /v1/sites/{id}/publish
POST   /v1/sites/{id}/unpublish
GET    /v1/domains
GET    /v1/domains/{id}/dns_records
POST   /v1/domains/{id}/dns_records
PATCH  /v1/domains/{id}/dns_records/{id}
DELETE /v1/domains/{id}/dns_records/{id}
GET    /v1/customers
POST   /v1/customers
GET    /v1/invoices        ?kind=invoice|quote
GET    /v1/invoices/{id}
POST   /v1/invoices
POST   /v1/invoices/{id}/issue
POST   /v1/invoices/{id}/cancel
GET    /v1/media
POST   /v1/media/uploads
POST   /v1/media/{id}/confirm
GET    /v1/brands
GET    /v1/brands/{id}

फ़ॉर्म उत्तरों की फ़ाइलें अपने नाम के साथ दिखाई देती हैं, किसी पते के साथ नहीं। आप उन्हें FormBuilder में डाउनलोड कर सकते हैं।

सूचियाँ, राशियाँ, समय

सूचियाँ नवीनतम पहले के क्रम में आती हैं, प्रति कॉल अधिकतम 100 प्रविष्टियाँ (limit, डिफ़ॉल्ट 25)। अगले पेज के लिए आप अंतिम प्रविष्टि की पहचान starting_after के रूप में भेजें; has_more बताता है कि और प्रविष्टियाँ बाकी हैं या नहीं।

राशियाँ मुद्रा की सबसे छोटी इकाई में पूर्णांक होती हैं — यूरो के लिए सेंट, येन के लिए पूरे येन। समय UTC में ISO 8601 के अनुसार होते हैं।

curl "https://api.kenjtec.com/v1/orders?payment_status=paid&limit=50" \
  -H "Authorization: Bearer kt_api_…"

त्रुटियाँ और सीमाएँ

हर त्रुटि का स्वरूप एक जैसा होता है: type और message के साथ एक error ऑब्जेक्ट। 401 का अर्थ है: कुंजी मौजूद नहीं है, गलत है या रद्द की जा चुकी है। 403 का अर्थ है: कुंजी में कोई आवश्यक अधिकार नहीं है — या खाते में अब कोई सशुल्क पैकेज नहीं है (type plan_required)। 404 का अर्थ है: यह मौजूद नहीं है, या यह आपके खाते से संबंधित नहीं है।

प्रति कुंजी एक मिनट में 120 अनुरोध किए जा सकते हैं। इससे अधिक होने पर API 429 के साथ उत्तर देती है और Retry-After में अगले प्रयास तक के सेकंड बताती है।

{
  "error": {
    "type": "permission_error",
    "message": "This API key lacks the scope 'orders:read'."
  }
}

API केवल कुंजियाँ स्वीकार करती है, ब्राउज़र में आपका साइन-इन कभी नहीं। कुंजी आपके सर्वर पर होनी चाहिए — कभी भी किसी वेबसाइट या ऐसे ऐप में नहीं, जिसे दूसरे लोग डाउनलोड करते हैं।