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

Bắt đầu nhanh

Thử cài CLI, thiết lập khóa API và đăng nội dung cho thương hiệu gắn với khóa đó.

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

Gói công khai là @anakonn/ankk và tên lệnh là ankk. CLI 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

Dùng khóa API từ Ankk. Kết quả lệnh che giá trị đầy đủ của khóa. Trong CI, bạn có thể cấu hình bằng biến môi trường.

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ị

Lưu nội dung vào tệp JSON rồi gửi đến cùng giao diện lên lịch công khai mà các ứng dụ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

Dùng --file để gửi nội dung. Script và công cụ AI có thể tạo tệp JSON mà không cần ghép nhiều tùy chọn dòng lệnh.

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

Không lưu tệp mẫu chứa dữ liệu khách hàng vào Git.
Dùng khóa idempotency để lặp lại tác vụ tự động một cách an toàn.
Đã tiếp nhận nghĩa là yêu cầu đã được xác thực, lưu và lên lịch. Hãy kiểm tra trạng thái cuối cùng để xác nhận đăng thành công.

Gọi trực tiếp API công khai

API

Các thao tác CLI tương ứng với API công khai /v1. Dùng xác thực Bearer; khóa API xác định thương hiệu cho các đường dẫn /v1/brand.

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

Dùng GET /v1/brand để xem thương hiệu gắn với khóa API.
Xem /v1/docs và /v1/openapi.json để biết đặc tả giao diện công khai.
Không dán khóa API đầy đủ vào nhật ký hoặc yêu cầu hỗ trợ.

Theo dõi trạng thái sau khi tiếp nhận yêu cầu

Trạng thái

Đã tiếp nhận nghĩa là yêu cầu đã được xác thực, lưu và lên lịch. Hãy kiểm tra trạng thái cuối cùng để xác nhận đăng thành công.

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

Mã trạng thái: accepted, queued, publishing, published, failed, retry.
Dùng webhook có chữ ký để gửi cập nhật trạng thái cho hệ thống khác.
Tiếp nhận yêu cầu là bước đầu tiên. Theo dõi từng bài đến kết quả đăng cuối cùng và xem xét lỗi khi cần.

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

Tự chuẩn bị nội dung hoặc dùng công cụ AI bên ngoài, lên lịch trên các kênh được hỗ trợ và theo dõi kết quả đăng bài trong Ankk.

Codex

Tạo dữ liệu bài giới thiệu trên Threads từ ghi chú phát hành này, lưu vào tmp/launch-thread.json, rồi chạy ankk contents publish với thương hiệu đã cấu hình của tôi.

Claude Code

Kiểm tra xem payload.json có đủ connection_id, idempotency_key, sns_type, text và scheduled_for không. Sau đó hiển thị lệnh ankk contents publish chính xác.

ChatGPT

Soạn ba phương án nội dung phù hợp với các kênh và trả về một tệp JSON có thể gửi bằng ankk contents publish --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.

Dùng Ankk qua CLI, APIvà công cụ AI