# Pengenalan

API PostFlow membuat kode Anda bisa melakukan apa yang dilakukan aplikasi: membaca akun yang tersambung, memasukkan foto dan
video, membuat draft, memeriksa, menjadwalkan dan menerbitkan post, membalas komentar dan pesan langsung, serta membaca analitik.
[Webhook](/id/guides/webhooks/) memberi tahu server Anda saat sesuatu terjadi. Asisten AI memakai fitur yang sama lewat
[MCP server](/id/agents/mcp/).

## Base URL

```text
https://postflow.biz.id/api/v1
```

Semua endpoint ada di bawah `/v1`. [Dokumen OpenAPI 3.1](https://postflow.biz.id/api/v1/openapi.json) menjelaskan semuanya;
impor ke Postman, Insomnia, Bruno atau generator client.

## Yang dibutuhkan

- Workspace PostFlow dengan langganan atau masa trial yang aktif. Membaca data selalu bisa; membuat dan menerbitkan post butuh
  langganan aktif.
- API key dari **Settings → Integrations → API & MCP** (pemilik workspace), dikirim sebagai `Authorization: Bearer pf_…`.
  Lihat [Autentikasi](/id/concepts/authentication/).

:::caution[Simpan key di server]
Satu key bisa menerbitkan post ke semua akun yang tersambung. Jangan taruh di kode browser, aplikasi mobile atau repository publik.
:::

## Konvensi

| | |
|---|---|
| Format | JSON masuk dan keluar (`Content-Type: application/json`), UTF-8. Upload file mengirim byte mentah. |
| Id | String acak. Jangan diurai. |
| Waktu | ISO 8601 dengan offset atau `Z` di request, mis. `2026-11-03T09:00:00+07:00`. Respons memakai UTC (`…Z`). |
| Zona waktu | Tiap workspace punya satu (default `Asia/Jakarta`), dikembalikan [`GET /me`](/api/operations/getworkspace/). Hari kalender, slot antrean dan hari analitik memakainya. |
| Error | `{ "error": { "code", "message", "details" } }` dengan status HTTP yang sesuai. Lihat [Error](/id/concepts/errors/). |
| Halaman | Cursor dan timestamp `before`. Lihat [Paginasi](/id/concepts/pagination/). |
| Batas | 120 request per menit per key. Lihat [Batas request](/id/concepts/rate-limits/). |

## Konsep

[Autentikasi](/id/concepts/authentication/)
  [Izin akses](/id/concepts/permissions/)
  [Batas request](/id/concepts/rate-limits/)
  [Error](/id/concepts/errors/)
  [Paginasi](/id/concepts/pagination/)
  [Versi](/id/concepts/versioning/)
## Endpoint

**Workspace dan akun**
[Workspace](/api/operations/getworkspace/) · [Akun](/api/operations/listaccounts/) · [Content type](/api/operations/listcontenttypes/)

**Post**
[Buat](/api/operations/createpost/) · [Validasi](/api/operations/validatepost/) · [Daftar](/api/operations/listposts/) · [Setujui](/api/operations/approvepost/)

**Kalender dan antrean**
[Kalender](/api/operations/getcalendar/) · [Slot antrean](/api/operations/getqueue/) · [Slot berikutnya](/api/operations/nextqueueslot/)

**Media**
[Impor](/api/operations/importmedia/) · [Upload](/api/operations/uploadmedia/) · [Daftar](/api/operations/listmedia/)

**Inbox**
[Komentar](/api/operations/listcomments/) · [Pesan](/api/operations/listconversations/)

**Analitik dan webhook**
[Analitik](/api/operations/getanalytics/) · [Webhook](/api/operations/listwebhooks/)

[Mulai cepat: post terjadwal dalam lima request](/id/quickstart/)