डेवलपर्स

CLI, API और AI टूल सेAnkk इस्तेमाल करें

Ankk CLI इंस्टॉल करें, API कुंजी सेट करें और Codex, Claude Code, ChatGPT, स्क्रिप्ट या ऑटोमेशन टूल से तैयार सामग्री को शेड्यूल करें।

टर्मिनल
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --file payload.json

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

CLI इंस्टॉल करें, API कुंजी सेट करें और उस कुंजी से जुड़े ब्रांड के लिए प्रकाशन का तरीका आज़माएं।

एक बार इंस्टॉल करें या चलाएं

सार्वजनिक पैकेज का नाम @anakonn/ankk और कमांड का नाम ankk है। CLI चलाने के लिए Bun चाहिए।

bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health

सुरक्षित रूप से कॉन्फ़िगर करें

Ankk की API कुंजी इस्तेमाल करें। कमांड के परिणाम में पूरी कुंजी छिपाई जाती है। CI में इसे पर्यावरण चर से सेट कर सकते हैं।

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 भेजें

पेलोड

सामग्री भेजने के लिए --file इस्तेमाल करें। स्क्रिप्ट और AI टूल कई कमांड विकल्प जोड़ने के बजाय JSON फ़ाइल बना सकते हैं।

{
	"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"
}
  • ग्राहक डेटा वाली उदाहरण फ़ाइलों को Git में न रखें।
  • ऑटोमेशन सुरक्षित रूप से दोहराने के लिए idempotency कुंजियां इस्तेमाल करें।
  • स्वीकार किया गया का अर्थ है कि अनुरोध की जांच हो गई, उसे सहेज लिया गया और शेड्यूल कर दिया गया। प्रकाशन की सफलता जानने के लिए अंतिम स्थिति देखें।

सार्वजनिक API को सीधे कॉल करें

API

CLI की क्रियाएं सार्वजनिक /v1 API से जुड़ी हैं। Bearer प्रमाणीकरण इस्तेमाल करें; API कुंजी /v1/brand के लिए ब्रांड तय करती है।

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

अनुरोध मिलने के बाद स्थिति देखें

स्थिति

स्वीकार किया गया का अर्थ है कि अनुरोध की जांच हो गई, उसे सहेज लिया गया और शेड्यूल कर दिया गया। प्रकाशन की सफलता जानने के लिए अंतिम स्थिति देखें।

ankk contents list --json
ankk contents get --content-id <content_id> --json
  • स्थिति कोड: accepted, queued, publishing, published, failed, retry.
  • दूसरे सिस्टम को स्थिति की जानकारी देने के लिए हस्ताक्षरित webhook इस्तेमाल करें।
  • अनुरोध स्वीकार होना पहला चरण है। हर पोस्ट को अंतिम प्रकाशन परिणाम तक देखें और ज़रूरत पड़ने पर विफलता की जांच करें।

Ankk का उपयोग करने के लिए AI टूल को संकेत दें, इसे बदलें नहीं

सामग्री खुद तैयार करें या बाहरी AI टूल की मदद लें, फिर समर्थित चैनलों पर पोस्ट शेड्यूल करें और Ankk में प्रकाशन के परिणाम देखें।

Codex

इस रिलीज़ नोट से Threads के लिए लॉन्च पोस्ट का डेटा बनाएं, उसे tmp/launch-thread.json में सहेजें, फिर मेरे सेट किए गए ब्रांड से ankk contents publish चलाएं।

Claude Code

जांचें कि payload.json में connection_id, idempotency_key, sns_type, text और scheduled_for हैं या नहीं। फिर सही ankk contents publish कमांड दिखाएं।

ChatGPT

चैनलों के लिए उपयुक्त पोस्ट के तीन रूप बनाएं और एक JSON फ़ाइल दें जिसे मैं ankk contents publish --file payload.json के साथ इस्तेमाल कर सकूं।

सुरक्षा सीमाएँ

  • पूर्ण spk_ API कुंजियां को मॉडल, लॉग, स्क्रीनशॉट या जारी टिप्पणियों में उजागर न करें।
  • उपयोगकर्ताओं को यह न बताएं कि कमांड की सफलता का मतलब है कि प्रदाता प्रकाशन पहले ही सफल हो चुका है।
  • छिपे हुए या निष्क्रिय CLI कमांड को सार्वजनिक सुविधाओं के रूप में दस्तावेज़ित न करें।
  • सीधे डेटाबेस एक्सेस के बजाय स्वचालन के लिए API कुंजियां, webhooks और स्थिति जांच का उपयोग करें।

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

CLI से शुरू करें, फिर वही JSON डेटा स्क्रिप्ट, CI कार्य या AI टूल में इस्तेमाल करें।