คู่มือ Ankk CLI/API สำหรับนักพัฒนา

เริ่มต้นอย่างรวดเร็ว

ทดลองติดตั้ง CLI ตั้งค่าคีย์ API และเผยแพร่ไปยังแบรนด์ที่ผูกกับคีย์นั้นตามลำดับ

ติดตั้งหรือรันครั้งเดียว

แพ็กเกจสาธารณะคือ @anakonn/ankk และชื่อคำสั่งคือ ankk การใช้ CLI ต้องมี Bun

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

กำหนดค่าอย่างปลอดภัย

ใช้คีย์ API จาก Ankk ผลลัพธ์คำสั่งจะปิดบังค่าคีย์เต็ม คุณสามารถตั้งค่าผ่านตัวแปรสภาพแวดล้อมใน 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 สอดคล้องกับ API สาธารณะ /v1 ใช้การยืนยันตัวตนแบบ 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

ใช้ GET /v1/brand เพื่อดูแบรนด์ที่ผูกกับคีย์ API
ดูข้อกำหนดอินเทอร์เฟซสาธารณะที่ /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 ที่มีลายเซ็นเพื่อส่งสถานะไปยังระบบอื่น
การรับคำขอเป็นขั้นตอนแรก ติดตามแต่ละโพสต์จนถึงผลการเผยแพร่สุดท้ายและตรวจสอบข้อผิดพลาดเมื่อจำเป็น

แจ้งเครื่องมือ AI ให้ใช้ Ankk ไม่ใช่แทนที่

เตรียมเนื้อหาเองหรือใช้เครื่องมือ 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, APIและเครื่องมือ AI