Referensi API

Segera Hadir — REST API publik saat ini ada di roadmap kami dan belum tersedia. Dokumentasi di bawah ini menjelaskan desain API yang direncanakan. Kami akan mengumumkan ketersediaannya di changelog kami.

REST API PostClaw akan memungkinkan Anda mengelola posting, platform, otomatisasi, dan pembuatan AI secara terprogram.

URL Dasar: https://app.postclaw.fun/v1

Autentikasi

Semua permintaan memerlukan token Bearer. Buat kunci API di Pengaturan → Kunci API.

curl https://app.postclaw.fun/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

Kunci memiliki cakupan: read, write, atau admin. Gunakan cakupan minimum yang diperlukan.

Batas Laju

Header batas laju dikembalikan pada setiap respons:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1743484800

Endpoint

Posting

# Daftar posting
GET /v1/posts?status=scheduled&limit=20

# Buat posting
POST /v1/posts
{
  "content": "Your caption here",
  "platforms": ["twitter", "linkedin"],
  "scheduled_at": "2026-04-01T09:00:00Z",
  "media_ids": ["media_abc123"]
}

# Ambil posting
GET /v1/posts/{id}

# Batalkan posting terjadwal
DELETE /v1/posts/{id}

Media

# Unggah media
POST /v1/media
Content-Type: multipart/form-data
# Mengembalikan: { "id": "media_abc123", "url": "...", "type": "image" }

# Daftar perpustakaan media
GET /v1/media?type=image&limit=50

Platform

# Daftar akun terhubung
GET /v1/platforms

# Putuskan akun
DELETE /v1/platforms/{id}

Pembuatan AI

# Buat teks posting
POST /v1/ai/text
{
  "prompt": "Announce our new feature: dark mode",
  "platform": "twitter",
  "tone": "casual"
}

# Buat gambar
POST /v1/ai/image
{
  "prompt": "Clean minimal desk setup, natural light",
  "size": "1024x1024"
}

Otomatisasi

# Daftar otomatisasi
GET /v1/automations

# Picu otomatisasi secara manual
POST /v1/automations/{id}/trigger
{ "input": "https://example.com/article" }

Webhook

Daftarkan URL untuk menerima event:

POST /v1/webhooks
{
  "url": "https://yoursite.com/postclaw-events",
  "events": ["post.published", "post.failed", "automation.completed"]
}

Struktur payload event:

{
  "event": "post.published",
  "timestamp": "2026-04-01T09:00:05Z",
  "data": {
    "post_id": "post_xyz789",
    "platform": "twitter",
    "url": "https://twitter.com/user/status/..."
  }
}

Respons Error

Semua error mengikuti format yang konsisten:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 60 seconds.",
    "retry_after": 60
  }
}

Kode error umum: unauthorized, forbidden, not_found, validation_error, rate_limit_exceeded, platform_error.

SDK

SDK resmi sedang dalam pengembangan. Untuk saat ini, gunakan klien HTTP apa pun. API didokumentasikan sepenuhnya di app.postclaw.fun/docs (spesifikasi OpenAPI 3.1 tersedia untuk diunduh).