Panduan Pengembang Ankk CLI/API

Mulai cepat

Coba instalasi CLI, pengaturan kunci API, dan publikasi ke merek yang terhubung dengan kunci tersebut.

Instal atau jalankan sekali

Paket publiknya adalah @anakonn/ankk dan nama perintahnya ankk. CLI memerlukan Bun.

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

Konfigurasikan dengan aman

Gunakan kunci API dari Ankk. Output perintah menyamarkan kunci lengkap. Untuk CI, Anda dapat memakai variabel lingkungan.

ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --api-key-env ANKK_API_KEY --yes
ankk config show

Publikasikan konten yang sudah disiapkan

Simpan konten dalam berkas JSON dan kirim melalui antarmuka penjadwalan publik yang sama dengan klien API.

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

Kirim JSON alih-alih membuat ulang formulir

Muatan

Gunakan --file untuk mengirim konten. Skrip dan alat AI dapat membuat berkas JSON tanpa merangkai banyak opsi perintah.

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

Jangan simpan berkas contoh berisi data pelanggan di Git.
Gunakan kunci idempotensi agar otomatisasi dapat diulang dengan aman.
Diterima berarti permintaan sudah divalidasi, disimpan, dan dijadwalkan. Periksa status akhir untuk memastikan publikasi berhasil.

Panggil API publik secara langsung

API

Operasi CLI menggunakan API publik /v1. Gunakan autentikasi Bearer; kunci API menentukan merek untuk rute /v1/brand.

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

Gunakan GET /v1/brand untuk memeriksa merek yang terhubung dengan kunci API.
Lihat /v1/docs dan /v1/openapi.json untuk spesifikasi antarmuka publik.
Jangan menempelkan kunci API lengkap ke log atau tiket dukungan.

Pantau status setelah permintaan diterima

Status

Diterima berarti permintaan sudah divalidasi, disimpan, dan dijadwalkan. Periksa status akhir untuk memastikan publikasi berhasil.

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

Kode status: accepted, queued, publishing, published, failed, retry.
Gunakan webhook bertanda tangan untuk mengirim pembaruan status ke sistem lain.
Penerimaan permintaan adalah langkah awal. Pantau setiap posting hingga hasil akhir publikasi dan tinjau kegagalan jika diperlukan.

Minta alat AI untuk menggunakan Ankk, bukan menggantinya

Siapkan konten sendiri atau dengan alat AI eksternal, jadwalkan ke kanal yang didukung, lalu pantau hasil publikasinya di Ankk.

Codex

Buat data posting peluncuran Threads dari catatan rilis ini, simpan di tmp/launch-thread.json, lalu jalankan ankk contents publish dengan merek yang sudah saya atur.

Claude Code

Periksa apakah payload.json memuat connection_id, idempotency_key, sns_type, text, dan scheduled_for. Lalu tampilkan perintah ankk contents publish yang tepat.

ChatGPT

Buat tiga variasi teks yang sesuai untuk kanal dan kembalikan satu berkas JSON yang dapat dikirim dengan ankk contents publish --file payload.json.

Batasan keamanan

Jangan tampilkan kunci API spk_ lengkap ke model, log, tangkapan layar, atau komentar issue.
Jangan beri tahu pengguna bahwa perintah sukses berarti penerbitan penyedia sudah berhasil.
Jangan mendokumentasikan perintah CLI yang tersembunyi atau tidak aktif sebagai fitur publik.
Gunakan kunci API, webhook, dan pemeriksaan status untuk otomatisasi alih-alih akses database langsung.

Gunakan Ankk melalui CLI, APIdan alat AI