डेवलपर्स

CLI, API से Ankk का उपयोग करें। और AI उपकरण

बन-फर्स्ट CLI स्थापित करें, एक सार्वजनिक API key कॉन्फ़िगर करें, और Codex, Claude Code, ChatGPT, स्क्रिप्ट, या ऑटोमेशन टूल से तैयार सामग्री को Ankk शेड्यूलिंग में भेजें।

terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json

त्वरित शुरुआत

एक छोटा पथ जो पैकेज, 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 --brand-ref <brand_ref> --api-key-env ANKK_API_KEY --yes
ankk config show

तैयार सामग्री प्रकाशित करें

एक JSON पेलोड बनाएं और इसे API क्लाइंट द्वारा उपयोग किए जाने वाले उसी सार्वजनिक शेड्यूलिंग अनुबंध को सौंप दें।

ankk brands list --json
ankk contents publish --brand-ref <brand_ref> --file payload.json
ankk contents publish --brand-ref <brand_ref> --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 प्रमाणीकरण और ब्रांड-स्कोप्ड मार्गों का उपयोग करें।

  • सुलभ ब्रांड खोजने के लिए GET /v1/brands का उपयोग करें।
  • सार्वजनिक अनुबंध के लिए /v1/docs और /v1/openapi.json का उपयोग करें।
  • लॉग या टिकट में कभी भी पूरा API keys पेस्ट न करें।
curl -X POST https://api-public.ankk.app/v1/brands/<brand_ref>/contents \
-H "Authorization: Bearer spk_..." \
-H "Content-Type: application/json" \
--data @payload.json
स्थिति

स्वीकृति के बाद कार्य को ट्रैक करें

प्रकाशन अतुल्यकालिक है. API मान्य कार्य को स्वीकार करता है, उसे जारी रखता है, और निष्पादन को शेड्यूल करता है; प्रदाता का समापन बाद में होता है।

  • अपेक्षित स्थितियों में स्वीकृत, कतारबद्ध, प्रकाशन, प्रकाशित, विफल और पुनः प्रयास शामिल हैं।
  • जब किसी अन्य सिस्टम को स्टेटस अपडेट की आवश्यकता हो तो signed webhooks का उपयोग करें।
  • परिचालन स्थिति AI प्रॉम्प्ट के बजाय Ankk में रहती है।
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json

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 और स्थिति जांच का उपयोग करें।

Ankk को अपने वर्कफ़्लो में जोड़ने के लिए तैयार हैं?

CLI से प्रारंभ करें, फिर उसी पेलोड को स्क्रिप्ट, CI जॉब, या AI टूल रन में ले जाएं।