API कुंजियां

अपनी कंपनी की API कुंजियाँ जनरेट और प्रबंधित करें ताकि Tenka को BI (Power BI, Metabase), स्प्रेडशीट या अपने स्वयं के सिस्टम के साथ इंटीग्रेट किया जा सके। प्रत्येक कुंजी REST API के माध्यम से आपके डेटा तक केवल-पठन पहुंच देती है।

केवल इसके लिए एक कुंजी बनाएँ। Excel में: डेटा ▸ डेटा प्राप्त करें ▸ अन्य स्रोतों से ▸ OData फ़ीड ▸ फ़ीड का URL चिपकाएँ; उन्नत में Authorization हेडर "Bearer SUA_CHAVE" मान के साथ जोड़ें। Excel तालिकाएँ (ग्राहक, अनुबंध, लेन-देन…) सूचीबद्ध करता है और पेज अपने-आप आगे बढ़ाता है। Power BI में वही रास्ता है (OData फ़ीड)।

किसी सेल में: =IMPORTDATA("…/api/v1/feed/csv/clientes.csv?api_key=SUA_CHAVE&sep=,&dec=.")। sep=, और dec=. से Sheets संख्याओं को संख्या के रूप में पढ़ता है। हर संसाधन की अपनी CSV है (contratos.csv, movimentacoes.csv…)।

सूची हर कुंजी को नाम, प्रीफ़िक्स, कब बनी और आख़िरी बार कब इस्तेमाल हुई, स्थिति, MCP दायरे और अनियमित पहचान के निशान के साथ दिखाती है। ऊपर एक व्यक्ति एक कुंजी के नियम, पहचान बदलाव की तैयारी और कुंजी बनाएँ पैनल है — कुंजी आपके नाम पर बनती है और सिर्फ़ एक बार खुले रूप में दिखती है: तुरंत कॉपी करें।

इसे एक नाम दें (जैसे: "Power BI इंटीग्रेशन") और कुंजी जनरेट करें पर क्लिक करें। कुंजी केवल एक बार दिखाई देती है — इसे कॉपी करें और किसी सीक्रेट वॉल्ट में सुरक्षित रखें। डेटाबेस में केवल हैश रहता है; बाद में सपोर्ट भी कुंजी पुनर्प्राप्त नहीं कर सकता। यदि यह लीक हो जाए या अब आवश्यक न हो, तो रद्द करें का उपयोग करें (इंटीग्रेशन तुरंत रुक जाता है)।

/api/v1/me — आपके tenant का डेटा।
/api/v1/clientes — id, कोड, नाम, CPF/CNPJ।
/api/v1/contratos — संख्या, स्थिति, वैधता।
/api/v1/movimentacoes — विवरण, राशि, नियत तिथि, स्थिति।
/api/v1/tickets — अनुरोध।

"अभी परीक्षण करें" ब्लॉक का उपयोग करें: कुंजी पेस्ट करें, संसाधन चुनें और परीक्षण पर क्लिक करें — Tenka अपना API कॉल करता है और JSON दिखाता है। या प्रत्येक एंडपॉइंट को दृश्य रूप से ब्राउज़ और परीक्षण करने के लिए "एक्सप्लोरर खोलें (Swagger UI)" पर क्लिक करें (Authorize बटन → कुंजी पेस्ट करें)। स्वचालित क्लाइंट जनरेट करने के लिए, OpenAPI विनिर्देश (JSON) डाउनलोड करें और इसे Postman या किसी कोड जनरेटर में आयात करें।

अगर कोई कुंजी दर्ज नहीं है, तो पैनल "बिना डेटा का मीटर" कहता है — "बदलने के लिए तैयार" नहीं। फ़र्क मायने रखता है: शून्य मौजूद कुंजियों में से शून्य चिह्नित कुंजियाँ कुछ साबित नहीं करतीं, और इसे मंज़ूरी मानना मीटर के झूठ बोलने का सबसे आम तरीका है। अगर माप सब कुछ वर्गीकृत नहीं कर पाता, तो वह भी चेताता है, अंदाज़े से गिनती पूरी करने के बजाय।

अपनी कुंजी के साथ: GET https://SEU-TENKA/api/v1/analitico डेटासेट (प्लेटफ़ॉर्म के और जो आपकी कंपनी ने BI में बनाए) उनके कॉलम और फ़िल्टर योग्य चीज़ों के साथ सूचीबद्ध करता है। डेटासेट लाने के लिए: GET /api/v1/analitico/financeiro?formato=csv — Power BI (डेटा प्राप्त करें ▸ वेब) और Metabase (CSV/URL स्रोत) इसे सीधे पढ़ते हैं। पैरामीटर: colunas=a,b · filtros=campo=valor;campo2>valor2;campo3~contem · agrupamento=campo · funcao=SOMA|MEDIA|CONTAGEM|MAIOR|MENOR|MEDIANA। JSON में count, truncado और regrasDeLinhaAplicadas आते हैं; CSV BOM के साथ आता है ताकि Excel उसे UTF-8 में खोले, और 1,000 पंक्तियों से ज़्यादा होने पर आख़िरी पंक्ति "# TRUNCADO" होती है।

Tenka का MCP सर्वर (/mcp, उसी कुंजी से) अब listar_datasets_bi (कैटलॉग), metricas_do_dataset_bi (किसी स्रोत में क्या मापा जा सकता है) और consultar_dataset_bi (पंक्तियाँ, या एक आयाम के अनुसार समूहन, प्रति जवाब 50 पंक्तियों तक, कुल घोषित करते हुए) देता है। आपके Tenka से जुड़ा AI सहायक "इस महीने हमने हर ग्राहक को कितना बेचा" का जवाब नियंत्रित डेटासेट पढ़कर देता है — डेटाबेस नहीं। कुंजी के मालिक के पंक्ति नियम और "मूल्य देखें" वैसे ही लागू होते हैं।

डेटासेट क्वेरी में ?fonte=snapshot जोड़ें (/api/v1/analitico/financeiro?fonte=snapshot&formato=csv) ताकि कंपनी के तय समय पर दर्ज स्नैपशॉट मिले, जवाब में atualizadoEm के साथ — तुरंत और ऑपरेशनल डेटाबेस को छुए बिना, Power BI को रात में अपडेट करने के लिए आदर्श। जब स्नैपशॉट न हो (नई कंपनी, या कुंजी के मालिक का पंक्ति नियम है जिसे स्नैपशॉट नहीं छाँटता), तो API लाइव जवाब देता है और यह `fonte` में बताता है।

GET /api/v1/analitico/{dataset}?pagina=2&tamanho=200 क्वेरी किए गए सेट (जो "truncado" में घोषित 1,000 पंक्तियों की सीमा का पालन करता है) की 200 पंक्तियों वाला दूसरा पेज लौटाता है। जवाब में pagina, tamanho, totalNaConsulta और temMais आते हैं। पैरामीटर के बिना पूरा सेट सीमा तक आता है, पहले की तरह। यह JSON और CSV दोनों पर लागू है।

समेटने योग्य "API कैसे इस्तेमाल करें" बॉक्स में नियम (प्रमाणीकरण, सिर्फ़ पढ़ना, कंपनी के अनुसार दायरा, पेजिनेशन और सीमा), एंडपॉइंट, चिपकाई गई कुंजी से API को बुलाने वाला टेस्टर और Excel, Power BI व Google Sheets के लिए तैयार फ़ीड URL हैं।

Com o A2A ligado na plataforma, outro agente de IA descobre o Tenkai em /.well-known/agent.json e pede tarefas em /a2a com a mesma chave de API: cada ferramenta de leitura é uma skill, com as mesmas permissões da chave e do usuário dono dela. Só leitura — escrita continua pelo MCP, em dois passos.

Na Central de Ajuda, em Área do desenvolvedor (/central-ajuda/desenvolvedores). À esquerda fica o guia — começar, autenticação, paginação, erros, limites, idempotência, webhooks e SDK — e a referência de cada operação. Em cada operação estão os parâmetros, os campos da resposta, as mensagens de erro e exemplos para copiar em cURL, JavaScript, Python, Java, C#, PHP e Node.

केवल बदले हुए रोल पढ़ने के लिए: GET /api/v1/rolos?desde=2026-10-17T00:00:00, हेडर Authorization: Bearer <आपकी कुंजी> के साथ; आखिरी मिले रोल की तारीख रखें और अगले desde में उसका उपयोग करें। प्रोसेसर को रोल भेजने के लिए: POST /api/v1/remessas, हेडर Authorization: Bearer <आपकी कुंजी> और Idempotency-Key: <हर शिपमेंट का एक अनोखा कोड> और बॉडी {"idFornecedor": 12, "tipoServico": "TINTURARIA", "rolos": [101, 102]} के साथ। उसी Idempotency-Key से कॉल दोहराने पर वही शिपमेंट लौटता है, दोहराव नहीं होता। कुंजी को लिखने की अनुमति चाहिए और वह केवल उन स्क्रीन तक पहुँचती है जो उसकी प्रोफ़ाइल देखती है।

हेडर में कुंजी भेजें Authorization: Bearer <key> (या X-API-Key). उदाहरण:
curl -H "Authorization: Bearer tnk_..." SEU_TENKA/api/v1/clientes?limit=50

कुंजी केवल आपकी कंपनी का डेटा देख सकती है (tenant अलगाव)। यह केवल-पठन (GET) है। पेजिनेशन ?limit (अधिकतम 200) और ?offset के माध्यम से। प्रति कुंजी प्रति मिनट 120 अनुरोधों की सीमा (अधिक होने पर HTTP 429 लौटाता है)।

सार्वजनिक API की हर कॉल एक व्यक्ति — कुंजी के मालिक — की पहुँच के साथ जवाब देती है। जब कुंजी का कोई मालिक न हो, या मालिक जा चुका हो, तो लागू करने को कोई पहुँच नहीं होती, और प्लेटफ़ॉर्म के तीन संभावित रुख़ हैं: देखना (केवल दर्ज करता है), चेताना (सेवा देता है और एक हेडर लौटाता है कि एक दिन मना करेगा) और मना करना (403, मुख्य भाग में कारण और सुधार के साथ)। आज खाता चेताने पर है।

क्योंकि समय से पहले बदलना उन लोगों का इंटीग्रेशन गिरा देता है जो खाते पर भरोसा करते हैं — और भरोसा करने वाले ठीक वही हैं जो नज़र नहीं रख रहे। मानदंड कभी समय-सीमा नहीं था: यह है कि यह स्क्रीन अब कोई चिह्नित कुंजी न दिखाए। जब तक एक भी है, तैयारी पैनल बताता है कि कितनी हैं, कौन-सी हैं और हर एक के साथ क्या करना है। शून्य पर पहुँचने पर वह बताता है कि तैयार है, और बदलाव बिना जोखिम का फ़ैसला बन जाता है।

फ़ीड v1 API ही है दूसरे प्रारूप में: केवल पढ़ने योग्य, कुंजी के खाते तक सीमित, उसी रेट-लिमिट के साथ। कुंजी रद्द करने से Excel और Sheets तुरंत कट जाते हैं। मुद्रा वाले कॉलम बिना मालिक की कुंजी के लिए API के नियम का पालन करते हैं।

पढ़ने वाला कुंजी का मालिक है। उसके समूह के पंक्ति नियम (पैनल ▸ घटक ▸ "इस स्रोत के लिए पंक्ति नियम") आपके किसी भी फ़िल्टर से पहले लागू होते हैं; मूल्य वाले कॉलम तभी आते हैं जब मालिक मूल्य देख सकता हो — गायब कॉलम मास्क है, त्रुटि नहीं। हर क्वेरी ऑडिट में निशान छोड़ती है (कौन, कौन-सा डेटासेट, कितनी पंक्तियाँ)। डेटाबेस से सीधा कनेक्शन जानबूझकर मौजूद नहीं है: वह कंपनियों के बीच अलगाव और मूल्यों के नियंत्रण को तोड़ देता।

API कुंजी रीसायकल बिन में नहीं जाती: हटाने (या रद्द करें बटन) से कुंजी रद्द होती है, तुरंत प्रमाणीकरण बंद हो जाता है और रद्दीकरण ऑडिट ट्रेल में रहता है। कार्ड पर सिर्फ़ नाम बदलता है; MCP (पढ़ना) और लिखने का दायरा दायरा बटन से बदलता है — खाली लिखना यानी कोई लिखना नहीं।

सेटिंग्स › API कुंजियाँ में "सैंडबॉक्स कुंजी बनाएँ" बटन tnk_sbx_ से शुरू होने वाली कुंजी जारी करता है। यह केवल सैंडबॉक्स के पते पर काम करती है: डेमो डेटा वाला एक अलग सर्वर, प्रोडक्शन के समान संस्करण पर, जो हर सप्ताह शुरुआती स्थिति में लौट आता है — पढ़ना और लिखना खुलकर परखें। यह 90 दिन और प्रतिदिन अधिकतम 1000 कॉल के लिए मान्य है; सीमा पार होने पर सैंडबॉक्स आधी रात तक "सीमा पूरी" लौटाता है। प्रोडक्शन इसे कारण बताकर अस्वीकार करता है, और सैंडबॉक्स प्रोडक्शन की कुंजी अस्वीकार करता है। बनाते समय कुंजी सहेज लें: यह केवल एक बार दिखती है।

जब प्लेटफ़ॉर्म A2A खोलता है और खाता उसे सेटिंग्स › पैरामीटर › इंटीग्रेशन में चालू करता है, तो कोई दूसरा AI एजेंट इस स्क्रीन की कुंजी से Tenkai से काम माँगता है। वह वही देखता है जो कुंजी का मालिक देखता है। पूछताछ तुरंत लौटती है। बिल चुकाने जैसे काम केवल प्रस्तावित होते हैं: काम इंतज़ार करता है, व्यक्ति अनुमति देता है और एजेंट उसी काम में पुष्टि करता है; उससे पहले कुछ सहेजा नहीं जाता, और प्रस्ताव 15 मिनट में समाप्त हो जाता है। काम की अनुमति देने के लिए कुंजी में वे काम चुनें जिन्हें वह प्रस्तावित कर सकती है। हर अनुरोध ऑडिट में दर्ज होता है।

रोल, लॉट, खेप, उत्पादन ऑर्डर, टेक शीट और कटिंग टिकट कुंजी से तभी निकलते हैं जब उसके मालिक को उस स्क्रीन की पहुँच हो जहाँ से डेटा आता है (रोल, लॉट का पता, बाहरी प्रोसेसिंग, उत्पादन ऑर्डर, टेक शीट, कटिंग ऑर्डर)। खेप खोलने या उत्पादन दर्ज करने के लिए कुंजी लेखन वाली हो और मालिक स्क्रीन में जोड़ सके। कुंजी उसके नाम पर बनाएँ जो ये स्क्रीन चलाता है; पहुँच न हो तो जवाब बताता है कि कौन-सी स्क्रीन चाहिए।

Tenant प्रशासक ("उपयोगकर्ता और एक्सेस समूह" के समान दर्शक)। कुंजियाँ पूरी कंपनी के लिए मान्य हैं — इन्हें पासवर्ड की तरह मानें।

यह यहाँ चिह्नित दिखता है। आज कॉल अभी भी सेवा पाती है और हेडर में चेतावनी के साथ लौटती है; बदलाव के बाद उसे 403 मिलने लगेगा। यह सबसे आम और सबसे ख़तरनाक मामला है: इंटीग्रेशन व्यक्ति के जाने के महीनों बाद भी काम करता रहता है, ऐसे व्यक्ति की पहुँच से जो अब कंपनी में काम नहीं करता। सुधार है हर सक्रिय व्यक्ति के लिए एक कुंजी जारी करना और पुरानी रद्द करना — मालिक बदलकर कुंजी का दोबारा उपयोग कभी नहीं।

ऐड-इन के लिए Microsoft Partner Center खाता, स्टोर में प्रकाशन और हर Office संस्करण के लिए रखरखाव चाहिए — और कोई भी प्रतिस्पर्धी उससे शुरुआत नहीं करता। OData फ़ीड Excel और Power BI का मूल रास्ता है, Mac और ब्राउज़र में काम करता है, और पहले से मौजूद स्प्रेडशीट में जुड़ जाता है।

पट्टी बताती है कि आप प्रोडक्शन में नहीं हैं: होमोलॉगेशन (वह सर्वर जहाँ टीम अगला संस्करण जाँचती है), सैंडबॉक्स (इंटीग्रेशन परीक्षण का वातावरण, हर सप्ताह फिर से बनने वाले डेमो डेटा के साथ) या डेवलपमेंट। इन सर्वरों से कोई ई-मेल, WhatsApp, बिलिंग, बिल, मोबाइल सूचना या किसी दूसरे सिस्टम को कॉल वास्तव में नहीं जाती: सब कुछ अवरुद्ध के रूप में दर्ज होता है। प्रोडक्शन में पट्टी नहीं दिखती।