AdForm — Dokumentasi Developer

#Panduan

• Pengantar — Ringkasan API publik AdForm — apa yang bisa dan belum bisa dilakukan hari ini, base URL, format response, dan cara integrasi yang paling umum.
• Mulai Cepat — Dari nol sampai panggilan API AdForm pertama yang berhasil, dalam lima langkah — minta key, simpan key, dapatkan ID produk, panggil endpoint, baca respons dan tangani galat.
• Autentikasi — Cara memakai API key AdForm — format key adk_, header X-API-Key, scope yang aktif, bentuk response error, rate limit, dan contoh curl, PHP, dan JavaScript.
• Pasang Form Order (Embed) — Cara memasang form order AdForm di website sendiri — snippet iframe siap salin, embed.js untuk tinggi otomatis, atribut kontainer, dan cara menangkap kejadian setelah form terkirim.

#API Reference

• Konvensi API — Aturan yang berlaku di seluruh endpoint ber-API-key AdForm — base URL, bentuk response sukses dan galat, header, CORS, tanggal, nomor telepon, rupiah, dan kebijakan perubahan.
• API Produk — Referensi lengkap dua operasi produk yang bisa dipanggil dengan API key AdForm — ambil snippet embed dan duplikat produk, beserta parameter, contoh, dan daftar error.
• Pencarian Pelanggan — Referensi endpoint POST /api/customer_lookup.php — cari pelanggan lewat satu nomor telepon, dapatkan riwayat pesanan singkat dan pesan pembuka siap kirim. Body, respons, kode galat, dan batas laju.
• Status Pesanan (server-ke-server) — Referensi API status pesanan AdForm: baca satu pesanan dan pindahkan statusnya lewat kunci API. Scope, penguncian optimistik, idempotensi terikat isi permintaan, dan seluruh kode error.
• Kode Error — Daftar lengkap status HTTP dan pesan galat yang benar-benar dikembalikan endpoint ber-API-key AdForm, apa artinya, dan tindakan yang tepat untuk masing-masing.
• Batas Penggunaan — Pembatasan laju yang benar-benar berlaku di AdForm — angkanya, dihitung per apa, jendela waktunya, apa yang dikembalikan saat terlampaui, dan header apa yang ada dan tidak ada.
• Webhook Keluar — Referensi webhook keluar AdForm — daftar event, bentuk amplop, contoh payload lengkap, skema tanda tangan HMAC beserta kode verifikasi, aturan kirim ulang, dan kode HTTP yang dianggap berhasil.

#Changelog

• Rilis Juli 2026 — Catatan perubahan dokumentasi developer AdForm dan keadaan API publik per Juli 2026, ditulis apa adanya termasuk yang belum tersedia.