Dokumentasi API & webhook

API anflip dipakai untuk membuat dan mengelola flipbook langsung dari sistem Anda, misalnya CMS, toko online, atau aplikasi internal, tanpa upload manual lewat dashboard. Webhook adalah kebalikannya: anflip yang memberi tahu sistem Anda saat sesuatu terjadi.

API tersedia di semua paket. Batas ukuran file, jumlah halaman, jumlah flipbook, dan penyimpanan mengikuti paket tim pemilik API key.

Kapan dipakai

• Katalog yang sering berubah. Sistem toko membuat PDF katalog harga terbaru tiap minggu dan mengirimnya ke anflip lewat API. Tautan flipbook dipasang otomatis di website.
• Terbitan rutin. Majalah, buletin, atau laporan bulanan langsung menjadi flipbook begitu PDF final selesai. Webhook flipbook.ready memberi tahu sistem Anda untuk mempublikasikan tautannya.
• Lead langsung ke tim sales. Webhook lead.created mengirim isian form lead pembaca ke CRM, WhatsApp, atau Telegram sales dalam hitungan detik.
• Banyak klien. Agensi membuat dan mengelola flipbook puluhan klien dari sistem internalnya.

Mulai cepat

1. Buka Dashboard → API, isi nama key (misalnya "Integrasi toko online"), lalu klik Buat key. Salin key yang muncul. Key hanya ditampilkan sekali.
2. Upload PDF pertama Anda:

curl -X POST https://manage.anflip.id/api/v1/ext/flipbooks \
  -H "Authorization: Bearer afl_xxxxxxxxxxxxxxxx" \
  -H "Accept: application/json" \
  -F "file=@katalog.pdf" \
  -F "title=Katalog Oktober" \
  -F "visibility=unlisted"

3. Tunggu konversi selesai lewat webhook flipbook.ready atau dengan mengecek GET /flipbooks/{id}, lalu bagikan public_url.

Autentikasi & aturan umum

Kirim API key di header setiap request:

Authorization: Bearer afl_xxxxxxxxxxxxxxxx
Accept: application/json

Objek flipbook

Semua endpoint menjawab flipbook dalam bentuk ini (di dalam data):

{
  "id": "01J9Z6K3Q4T8V2N5M7P0R1S3W4",
  "title": "Katalog Oktober",
  "slug": "5f2a9c01be",
  "status": "ready",
  "visibility": "unlisted",
  "page_count": 24,
  "progress": 100,
  "converting": false,
  "has_live_version": true,
  "has_password": false,
  "allow_download": false,
  "error": null,
  "cover_url": "https://cdn.anflip.id/fb/01J9…/v1/p1-md.webp",
  "public_url": "https://anflip.id/flip-book/5f2a9c01be",
  "storage_bytes": 5241880,
  "created_at": "2026-10-01T02:00:00+00:00",
  "processed_at": "2026-10-01T02:00:41+00:00",
  "published_at": "2026-10-01T02:00:00+00:00"
}

Endpoint

Membuat flipbook

POST /flipbooks, dikirim sebagai multipart/form-data. Konversi berjalan di latar belakang, jadi respons langsung datang dengan status 202 dan status: "queued".

Daftar flipbook

GET /flipbooks menjawab 50 flipbook terbaru per halaman. Pakai ?page=2 untuk halaman berikutnya. Informasi halaman ada di meta (current_page, last_page, total).

Detail flipbook

GET /flipbooks/{id} menjawab satu flipbook. Cocok untuk mengecek status konversi.

Menghapus flipbook

DELETE /flipbooks/{id}. Tautan flipbook langsung berhenti bekerja. Respons: { "data": { "id": "…", "deleted": true } }.

Menunggu konversi selesai

PDF 20–50 halaman biasanya selesai dalam 1 menit; PDF ratusan halaman bisa beberapa menit. Ada dua cara menunggunya:

• Webhook flipbook.ready (disarankan). Tidak perlu bertanya berulang-ulang; anflip yang memberi tahu begitu selesai.
• Polling. Cek GET /flipbooks/{id} tiap 5–10 detik sampai has_live_version bernilai true atau status bernilai failed.

async function waitUntilReady(id) {
  for (;;) {
    const res = await fetch(`https://manage.anflip.id/api/v1/ext/flipbooks/${id}`, {
      headers: { Authorization: `Bearer ${process.env.ANFLIP_KEY}`, Accept: "application/json" },
    });
    const { data } = await res.json();
    if (data.has_live_version) return data.public_url;
    if (data.status === "failed") throw new Error(data.error);
    await new Promise((r) => setTimeout(r, 8000));
  }
}

Kode error

Contoh respons 422:

{
  "message": "Paket Anda mengizinkan 5 flipbook. Hapus yang lama atau upgrade paket.",
  "errors": { "file": ["Paket Anda mengizinkan 5 flipbook. Hapus yang lama atau upgrade paket."] }
}

Webhook

Mendaftarkan webhook

Di Dashboard → API → Webhook:

1. Isi URL di sistem Anda. URL harus https:// dan bisa diakses dari internet (bukan localhost atau IP jaringan lokal).
2. Pilih event yang ingin diterima, lalu klik Tambah webhook.
3. Salin signing secret (berawalan whsec_) yang muncul. Nilai ini hanya ditampilkan sekali dan dipakai untuk memverifikasi kiriman.
4. Kirim ping untuk mencoba. Status kiriman terakhir tampil di daftar webhook.

Maksimal 5 webhook per tim.

Event

Isian lead.created hanya berisi kolom yang dipakai di form: name, email, phone, company, dan message.

Bentuk kiriman

anflip mengirim POST dengan body JSON seperti ini:

{
  "id": "evt_01J9Z7A2B3C4D5E6F7G8H9J0K1",
  "event": "lead.created",
  "created_at": "2026-10-01T03:30:00+00:00",
  "data": {
    "id": 128,
    "flipbook": { "id": "01J9Z6K3Q4T8V2N5M7P0R1S3W4", "title": "Katalog Oktober", "url": "https://anflip.id/flip-book/5f2a9c01be" },
    "data": { "name": "Sari", "email": "sari@example.com", "phone": "081234567890" },
    "created_at": "2026-10-01T03:30:00+00:00"
  }
}

Header yang ikut dikirim:

Memverifikasi tanda tangan

Selalu cek tanda tangan sebelum memproses, supaya kiriman palsu tidak diterima. Hitung HMAC dari body mentah (persis seperti diterima, sebelum di-parse menjadi JSON).

// Node.js (Express): app.post("/anflip-webhook", express.raw({ type: "application/json" }), handler)
import crypto from "node:crypto";

function verify(rawBody, header, secret) {
  const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(header ?? "");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

// PHP / Laravel
$expected = 'sha256='.hash_hmac('sha256', $request->getContent(), env('ANFLIP_WEBHOOK_SECRET'));
abort_unless(hash_equals($expected, (string) $request->header('X-Anflip-Signature')), 401);

# Python (Flask)
import hashlib, hmac

def verify(raw_body: bytes, header: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header or "")

Balasan, pengulangan, dan praktik terbaik

• Balas 2xx dalam 10 detik. Simpan kiriman lalu proses di latar belakang (antrean). Jangan menunggu proses panjang sebelum membalas.
• Kiriman yang gagal diulang (bukan 2xx, timeout, atau tidak bisa terhubung) hingga total 5 kali, dengan jeda 10 detik, 1 menit, 5 menit, lalu 30 menit.
• Tangani duplikat. Karena ada pengulangan, event yang sama bisa datang lebih dari sekali. Simpan id event (evt_…) dan abaikan yang sudah pernah diproses.
• Urutan tidak dijamin. Bila urutan penting, pakai created_at.
• Redirect tidak diikuti. Daftarkan URL akhir yang benar, bukan URL yang dialihkan.

Contoh lengkap: katalog mingguan

Sistem toko membuat katalog.pdf tiap Senin, mengirimnya ke anflip, lalu memasang tautannya di website begitu siap.

// Laravel: dijalankan scheduler tiap Senin
$response = Http::withToken(env('ANFLIP_KEY'))->acceptJson()
    ->attach('file', file_get_contents(storage_path('katalog.pdf')), 'katalog.pdf')
    ->post('https://manage.anflip.id/api/v1/ext/flipbooks', [
        'title' => 'Katalog '.now()->translatedFormat('j F Y'),
        'visibility' => 'unlisted',
    ])->throw();

Setting::put('katalog_pending', $response->json('data.id'));

// Route webhook: POST /anflip-webhook
$expected = 'sha256='.hash_hmac('sha256', $request->getContent(), env('ANFLIP_WEBHOOK_SECRET'));
abort_unless(hash_equals($expected, (string) $request->header('X-Anflip-Signature')), 401);

if ($request->input('event') === 'flipbook.ready'
    && $request->input('data.id') === Setting::get('katalog_pending')) {
    Setting::put('katalog_url', $request->input('data.public_url')); // tampil di website
}

return response()->noContent();

Tanpa kode

• Google Sheets dan Mailchimp bisa dihubungkan langsung di Dashboard → Integrasi, tanpa API.
• Aplikasi lain (CRM, Slack, email, WhatsApp gateway): sambungkan webhook ke Zapier, Make, atau n8n memakai trigger "Catch webhook" / "Webhooks", lalu teruskan ke aplikasi tujuan.

Buka pengaturan API