Ankk CLI/API Hướng dẫn dành cho nhà phát triển

Bắt đầu nhanh

Một đường dẫn nhỏ chứng minh gói, khóa API và quy trình xuất bản trong phạm vi thương hiệu.

Cài đặt hoặc chạy một lần

Gói công khai là @anakonn/ankk và tệp nhị phân là ankk. CLI hiện yêu cầu Bun.

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

Định cấu hình an toàn

Sử dụng khóa API từ Ankk. Đầu ra lệnh sắp xếp lại khóa đầy đủ và các biến môi trường hoạt động cho 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

Xuất bản nội dung đã chuẩn bị

Tạo tải trọng JSON và chuyển nó cho cùng một hợp đồng lập lịch công khai được khách hàng API sử dụng.

ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Z

Gửi JSON thay vì tạo lại biểu mẫu

Tải trọng

Sử dụng —file cho nội dung nội dung để tập lệnh và công cụ AI có thể tạo ra tải trọng có cấu trúc mà không cần có nhiều cờ dễ vỡ.

{
  "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"
}

Giữ cố định tải trọng bên ngoài git khi chúng chứa dữ liệu khách hàng.
Sử dụng khóa tạm thời để tự động hóa có thể lặp lại.
Điều trị được chấp nhận theo lịch trình, không phải do nhà cung cấp thành công.

Gọi trực tiếp cho công chúng API

API

Mỗi quy trình làm việc CLI ánh xạ trở lại /v1 API công khai. Sử dụng xác thực Bearer và các tuyến trong phạm vi thương hiệu cho khách hàng tự động hóa.

curl -X POST https://api-public.ankk.app/v1/brand/contents 
  -H "Authorization: Bearer spk_..." 
  -H "Content-Type: application/json" 
  --data @payload.json

Sử dụng GET /v1/brand để khám phá các thương hiệu có thể truy cập.
Sử dụng /v1/docs và /v1/openapi.json cho hợp đồng công khai.
Không bao giờ dán toàn bộ khóa API vào nhật ký hoặc vé.

Theo dõi công việc sau khi nghiệm thu

Trạng thái

Xuất bản không đồng bộ. API chấp nhận công việc đã được xác thực, duy trì công việc đó và lên lịch thực hiện; việc hoàn thành nhà cung cấp xảy ra sau đó.

ankk contents list --json
ankk contents get --content-id <content_id> --json

Các trạng thái dự kiến bao gồm đã chấp nhận, đang xếp hàng, đang xuất bản, đã xuất bản, không thành công và thử lại.
Sử dụng webhooks đã ký khi hệ thống khác cần cập nhật trạng thái.
Trạng thái hoạt động vẫn ở Ankk thay vì dấu nhắc AI.

Nhắc các công cụ AI sử dụng Ankk, không thay thế nó

Hãy để công cụ AI chuẩn bị bản sao, tải trọng hoặc lệnh. Ankk vẫn là hệ thống lập lịch và trạng thái.

Codex

Tạo tải trọng khởi chạy Threads từ ghi chú phát hành này, lưu nó dưới dạng tmp/launch-thread.json, sau đó chạy xuất bản nội dung ankk với thương hiệu đã định cấu hình của tôi.

Claude Code

Kiểm tra payload.json xem có thiếu kết nối_id, idempotency_key, sns_type, văn bản và theo lịch_for hay không. Sau đó hiển thị lệnh xuất bản nội dung ankk chính xác.

ChatGPT

Soạn thảo ba biến thể bài đăng an toàn cho kênh và trả về một tải trọng JSON mà tôi có thể chuyển tới ankk nội dung xuất bản —file payload.json.

Ranh giới an toàn

Không hiển thị toàn bộ khóa spk_ API cho mô hình, nhật ký, ảnh chụp màn hình hoặc đưa ra nhận xét.
Đừng nói với người dùng rằng lệnh thành công nghĩa là việc xuất bản của nhà cung cấp đã thành công.
Không ghi lại các lệnh CLI ẩn hoặc không hoạt động dưới dạng tính năng công khai.
Sử dụng khóa API, webhooks và kiểm tra trạng thái để tự động hóa thay vì truy cập cơ sở dữ liệu trực tiếp.

Sử dụng Ankk từ CLI, API, và AI