त्वरित शुरुआत
एक छोटा पथ जो पैकेज, API key और ब्रांड-स्कोप्ड प्रकाशन वर्कफ़्लो को साबित करता है।
एक बार इंस्टॉल करें या चलाएं
सार्वजनिक पैकेज @anakonn/ankk है और बाइनरी ankk है। CLI को वर्तमान में बन की आवश्यकता है।
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json healthसुरक्षित रूप से कॉन्फ़िगर करें
Ankk से API key का उपयोग करें। कमांड आउटपुट पूरी कुंजी को रिडक्ट करता है, और पर्यावरण चर सीआई के लिए काम करते हैं।
ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --api-key-env ANKK_API_KEY --yes
ankk config showतैयार सामग्री प्रकाशित करें
एक JSON पेलोड बनाएं और इसे API क्लाइंट द्वारा उपयोग किए जाने वाले उसी सार्वजनिक शेड्यूलिंग अनुबंध को सौंप दें।
ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Zप्रपत्रों का पुनर्निर्माण करने के बजाय JSON भेजें
पेलोड
content bodies के लिए —file इस्तेमाल करें ताकि scripts और AI tools fragile flags के ढेर के बिना structured payloads बना सकें।
{
"connection_id": "<connection_id>",
"idempotency_key": "launch-thread-2026-07-01",
"sns_type": "threads",
"text": "Launch update from Ankk",
"scheduled_for": "2026-07-01T09:00:00Z"
}- जब उनमें ग्राहक डेटा हो तो पेलोड फिक्स्चर को गिट के बाहर रखें।
- दोहराने योग्य स्वचालन के लिए निष्क्रियता कुंजियों का उपयोग करें।
- स्वीकृत को निर्धारित मानें, प्रदाता-सफल नहीं।
जनता को सीधे API पर कॉल करें
API
प्रत्येक CLI वर्कफ़्लो वापस सार्वजनिक /v1 API पर मैप होता है। स्वचालन ग्राहकों के लिए Bearer प्रमाणीकरण और ब्रांड-स्कोप्ड मार्गों का उपयोग करें।
curl -X POST https://api-public.ankk.app/v1/brand/contents
-H "Authorization: Bearer spk_..."
-H "Content-Type: application/json"
--data @payload.json- सुलभ ब्रांड खोजने के लिए GET /v1/brand का उपयोग करें।
- सार्वजनिक अनुबंध के लिए /v1/docs और /v1/openapi.json का उपयोग करें।
- लॉग या टिकट में कभी भी पूरा API keys पेस्ट न करें।
स्वीकृति के बाद कार्य को ट्रैक करें
स्थिति
प्रकाशन अतुल्यकालिक है. API मान्य कार्य को स्वीकार करता है, उसे जारी रखता है, और निष्पादन को शेड्यूल करता है; प्रदाता का समापन बाद में होता है।
ankk contents list --json
ankk contents get --content-id <content_id> --json- अपेक्षित स्थितियों में स्वीकृत, कतारबद्ध, प्रकाशन, प्रकाशित, विफल और पुनः प्रयास शामिल हैं।
- जब किसी अन्य सिस्टम को स्टेटस अपडेट की आवश्यकता हो तो signed webhooks का उपयोग करें।
- परिचालन स्थिति AI प्रॉम्प्ट के बजाय Ankk में रहती है।
Ankk का उपयोग करने के लिए AI टूल को संकेत दें, इसे बदलें नहीं
AI टूल को कॉपी, पेलोड या कमांड तैयार करने दें। Ankk शेड्यूलिंग और स्थिति प्रणाली बनी हुई है।
Codex
इस रिलीज़ नोट से एक Threads लॉन्च पेलोड बनाएं, इसे tmp/launch-thread.json के रूप में सहेजें, फिर मेरे कॉन्फ़िगर किए गए ब्रांड के साथ ankk सामग्री प्रकाशित करें।
Claude Code
missing connection_id, idempotency_key, sns_type, text, और scheduled_for के लिए payload.json का निरीक्षण करें। फिर सटीक ankk contents publish command दिखाएं।
ChatGPT
तीन channel-safe post variants ड्राफ्ट करें और एक JSON payload लौटाएँ जिसे मैं ankk contents publish —file payload.json में पास कर सकूँ।
सुरक्षा सीमाएँ
- पूर्ण spk_ API keys को मॉडल, लॉग, स्क्रीनशॉट या जारी टिप्पणियों में उजागर न करें।
- उपयोगकर्ताओं को यह न बताएं कि कमांड की सफलता का मतलब है कि प्रदाता प्रकाशन पहले ही सफल हो चुका है।
- छिपे हुए या निष्क्रिय CLI कमांड को सार्वजनिक सुविधाओं के रूप में दस्तावेज़ित न करें।
- सीधे डेटाबेस एक्सेस के बजाय स्वचालन के लिए API keys, webhooks और स्थिति जांच का उपयोग करें।