Nhà phát triển

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

Cài đặt Bun-first CLI, định cấu hình khóa API công khai và gửi nội dung đã chuẩn bị sẵn từ Codex, Claude Code, ChatGPT, tập lệnh hoặc công cụ tự động hóa vào lịch trình Ankk.

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

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 --brand-ref <brand_ref> --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 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
Tải trọng

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

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ỡ.

  • 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.
{
"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

Gọi trực tiếp cho công chúng 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.

  • Sử dụng GET /v1/brands để 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é.
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
Trạng thái

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

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 đó.

  • 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.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json

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.

Bạn đã sẵn sàng kết nối Ankk vào quy trình làm việc của mình chưa?

Bắt đầu với CLI, sau đó chuyển tải trọng tương tự vào tập lệnh, công việc CI hoặc chạy công cụ AI.