Pengantar

AdForm adalah platform landing page + form order untuk penjual online di Indonesia. Satu akun (tenant) punya katalog produk, form order yang bisa ditempel di mana saja, dashboard pesanan, otomasi CS WhatsApp, dan integrasi pembayaran.

Halaman ini untuk developer di luar AdForm — tim CRM, tool otomasi, agency, atau staf teknis tenant AdForm sendiri — yang mau menyambungkan produknya ke AdForm.

#Base URL

https://adform.id

Semua endpoint API ada di bawah /api/. Tidak ada prefix versi (/v1/) — API ini belum diversikan. Kalau nanti ada perubahan yang tidak backward-compatible, kami umumkan lewat halaman ini dulu.

Response selalu JSON (Content-Type: application/json). Status HTTP dipakai apa adanya: 200/201 sukses, 4xx kesalahan dari sisi pemanggil, 5xx kesalahan di sisi kami.

#Yang bisa dilakukan API hari ini

Jujur saja: permukaan API dengan API key masih dua operasi, dua-duanya di endpoint produk.

Detail lengkap ada di API Produk. Cara membuat dan memakai key ada di Autentikasi.

Dua operasi ini cukup untuk pola integrasi yang paling sering diminta: tool eksternal menyalin produk template jadi produk baru, lalu langsung dapat URL form + snippet iframe yang siap dipasang. Itu inti kenapa endpoint ini ada.

#Yang BELUM bisa dilakukan API

Kami tulis eksplisit supaya Anda tidak membangun di atas asumsi yang salah:

• Tidak ada CRUD produk lewat API key. Tidak bisa list produk, ambil detail lengkap, membuat produk dari nol, mengubah, atau menghapus. Verb POST/PATCH/DELETE biasa di /api/products.php dipakai dashboard dan butuh sesi login dashboard, bukan API key.
• Tidak ada API pesanan. Tidak ada endpoint untuk membaca, membuat, atau mengubah pesanan dengan API key.
• Tidak ada API pelanggan. Resource ini belum ada sama sekali.
• Tidak ada API tim / CS. Belum tersedia untuk pihak ketiga.
• Belum ada webhook keluar. AdForm belum mengirim notifikasi otomatis ke server Anda saat ada pesanan masuk. Statusnya ada di Webhook.
• Belum ada sandbox / environment test terpisah. Semua panggilan mengenai data produksi tenant. Saat mengembangkan, pakai produk uji coba, jangan produk yang sedang dipakai jualan.

Kalau butuh sesuatu di daftar ini, kabari kami (lihat bagian paling bawah) — permintaan nyata dari integrator yang menentukan urutan pengerjaan.

#Cara integrasi yang paling umum

Untuk sebagian besar kasus, Anda tidak butuh API sama sekali — cukup pasang form order AdForm sebagai iframe di halaman Anda:

<iframe src="https://adform.id/t/12/kaos-polos-hitam"
  style="width:100%;min-height:700px;border:none;"
  loading="eager" scrolling="no" frameborder="0"></iframe>
<script src="https://adform.id/embed.js"></script>

embed.js bertugas menyesuaikan tinggi iframe otomatis, meneruskan parameter iklan (fbclid, gclid, utm_*) dari halaman induk ke form, dan menyalakan Meta Pixel / GTM sesuai setelan produk. Snippet persis untuk tiap produk — termasuk tenant_id dan slug yang benar — bisa diambil lewat ?action=embed, jadi Anda tidak perlu merangkainya sendiri.

Form ini menerima order langsung dari browser pengunjung. Pengiriman order dari server ke server tanpa form AdForm belum punya kontrak publik yang kami dokumentasikan.

#Autentikasi singkat

API key dikirim di header X-API-Key. Key selalu diawali adk_.

curl -H "X-API-Key: adk_0123456789abcdef0123456789abcdef0123456789abcdef" \
  "https://adform.id/api/products.php?action=embed&id=12"

Satu key terikat ke satu tenant. Semua data yang Anda akses dengan key itu adalah data tenant tersebut, tidak pernah tenant lain. Baca Autentikasi untuk format key, scope, error, dan rate limit.

#Batasan yang perlu Anda tahu sejak awal

• Rate limit per IP, bukan per key. 60 request per menit per alamat IP ke /api/products.php, dihitung bersama trafik lain dari IP yang sama. Rancang integrasi Anda dengan asumsi ini.
• Key adalah rahasia server. Jangan pernah menaruh API key di kode frontend, aplikasi mobile, atau repo publik. Tidak ada pembatasan origin/domain pada key.
• Rupiah dalam bilangan bulat. Semua harga adalah integer rupiah tanpa desimal (150000 = Rp150.000).

#Yang sedang disiapkan

Tanpa janji tanggal:

• Webhook keluar untuk event pesanan — lihat Webhook.
• Halaman self-service di dashboard untuk membuat dan mencabut API key sendiri.
• Endpoint baca katalog produk untuk API key.

Kami sengaja tidak mendokumentasikan kontrak yang belum final. Kalau ada di dokumentasi ini, artinya sudah jalan di produksi hari ini.

#Butuh bantuan atau butuh endpoint baru?

Hubungi tim AdForm lewat Pusat Bantuan. Sertakan nama produk/perusahaan Anda, alur integrasi yang diinginkan, dan endpoint apa yang Anda butuhkan. Untuk kebutuhan integrasi partner, sebutkan juga volume request perkiraan per hari.