API Produk

Endpoint /api/products.php melayani dua operasi programatik yang bisa dipanggil dengan API key. Operasi dipilih lewat query parameter action.

action wajib. Tanpa action, request masuk ke jalur dashboard yang butuh sesi login, bukan API key — API key Anda akan diabaikan di jalur itu. action yang tidak dikenal dibalas 400:

{ "error": "Unknown action: list" }

Semua harga adalah integer rupiah tanpa desimal (150000 = Rp150.000).

#Ambil snippet embed produk

GET /api/products.php?action=embed&id={id}
X-API-Key: adk_...

Scope: products:read.

Mengembalikan harga, varian, dan potongan HTML siap tempel untuk satu produk. Ini cara yang benar untuk mendapatkan URL form dan snippet iframe — jangan merangkainya sendiri, karena bentuk URL bergantung pada tenant_id dan slug produk.

#Parameter

#Contoh request

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

#Contoh response — 200 OK

{
  "success": true,
  "id": 12,
  "name": "Kaos Polos Hitam",
  "slug": "kaos-polos-hitam",
  "price": 89000,
  "sale_price": 69000,
  "variants": [
    { "dimension": "Ukuran", "options": ["M", "L", "XL"] }
  ],
  "variant_prices": [69000, 69000, 79000],
  "variant_display": "small",
  "embed": {
    "product_id": 12,
    "tenant_id": 34,
    "slug": "kaos-polos-hitam",
    "form_url": "https://adform.id/t/34/kaos-polos-hitam",
    "iframe": "<iframe src=\"https://adform.id/t/34/kaos-polos-hitam\"\n  style=\"width:100%;min-height:700px;border:none;\"\n  loading=\"eager\" scrolling=\"no\" frameborder=\"0\"></iframe>",
    "iframe_with_pixel": "<iframe src=\"https://adform.id/t/34/kaos-polos-hitam\"\n  style=\"width:100%;min-height:700px;border:none;\"\n  loading=\"eager\" scrolling=\"no\" frameborder=\"0\"></iframe>\n<script src=\"https://adform.id/embed.js\"></script>"
  }
}

#Field response

#Bentuk variants dan variant_prices

Produk tanpa varian: variants berupa array kosong dan variant_prices kosong. Harga diambil dari price / sale_price.

Produk dengan satu variasi:

{
  "variants": [{ "dimension": "Ukuran", "options": ["M", "L", "XL"] }],
  "variant_prices": [69000, 69000, 79000]
}

variant_prices adalah daftar angka datar, indeksnya sejajar dengan options.

Produk dengan dua variasi (matriks Variasi 1 × Variasi 2):

{
  "variants": [
    { "dimension": "Warna", "options": ["Hitam", "Putih"] },
    { "dimension": "Ukuran", "options": ["M", "L", "XL"] }
  ],
  "variant_prices": [
    [69000, 69000, 79000],
    [72000, 72000, 82000]
  ]
}

Baris = opsi variasi pertama, kolom = opsi variasi kedua. Jadi Putih/XL = variant_prices[1][2] = 82000.

Produk lama bisa memakai format varian datar tanpa field dimension. Perlakukan keberadaan dimension sebagai penanda format, seperti yang dilakukan form AdForm sendiri.

#Duplikat produk

POST /api/products.php?action=duplicate&id={id}
X-API-Key: adk_...
Content-Type: application/json

Scope: products:write.

Menyalin produk yang sudah ada menjadi produk baru di tenant yang sama, dengan nama baru dan (opsional) harga/varian/gambar yang di-override. Response langsung berisi embed, jadi satu panggilan sudah cukup untuk mendapat produk baru plus snippet siap pasang.

Kirim sebagai POST dengan body JSON — parameter override dibaca dari body, jadi request tanpa body tidak akan berhasil.

#Parameter query

#Parameter body (JSON)

Pada price_mode: "satuan", varian produk baru dikosongkan — produk hasilnya jadi produk harga tunggal meskipun sumbernya bervarian.

#Yang ikut tersalin

Selain nama dan slug, produk baru mewarisi konfigurasi produk sumber: deskripsi, berat, metode pembayaran dan channel e-payment, setelan COD, distribusi CS, setelan checkout, order bump, template follow-up, template redirect pelanggan, ID Meta Pixel dan GTM, label form, form_fields, tipe produk (termasuk produk digital), serta penugasan tim (product_team) dari produk sumber.

Status produk baru mengikuti status produk sumber. Kalau sumbernya aktif, hasil duplikat langsung aktif dan formnya bisa diakses publik. Kalau Anda ingin menyiapkan dulu, duplikat dari produk sumber yang nonaktif.

#Contoh — duplikat sederhana

curl -sS -X POST \
  -H "X-API-Key: adk_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kaos Polos Hitam - Promo Juli"}' \
  "https://adform.id/api/products.php?action=duplicate&id=12"

#Contoh — jadikan produk harga tunggal

{
  "name": "Kaos Polos Hitam - Edisi Promo",
  "slug": "kaos-hitam-promo",
  "price_mode": "satuan",
  "price": 79000,
  "sale_price": 59000
}

#Contoh — ganti struktur varian

{
  "name": "Kaos Polos - Katalog Baru",
  "price_mode": "varian",
  "price": 69000,
  "variants": [
    { "dimension": "Warna", "options": ["Hitam", "Putih"] },
    { "dimension": "Ukuran", "options": ["M", "L"] }
  ],
  "variant_prices": [
    [69000, 74000],
    [69000, 74000]
  ],
  "variant_compare_prices": [
    [89000, 94000],
    [89000, 94000]
  ],
  "variant_display": "small"
}

#Contoh response — 201 Created

{
  "success": true,
  "id": 87,
  "slug": "kaos-polos-hitam-promo-juli",
  "source_id": 12,
  "embed": {
    "product_id": 87,
    "tenant_id": 34,
    "slug": "kaos-polos-hitam-promo-juli",
    "form_url": "https://adform.id/t/34/kaos-polos-hitam-promo-juli",
    "iframe": "<iframe src=\"https://adform.id/t/34/kaos-polos-hitam-promo-juli\"\n  style=\"width:100%;min-height:700px;border:none;\"\n  loading=\"eager\" scrolling=\"no\" frameborder=\"0\"></iframe>",
    "iframe_with_pixel": "<iframe src=\"https://adform.id/t/34/kaos-polos-hitam-promo-juli\"\n  style=\"width:100%;min-height:700px;border:none;\"\n  loading=\"eager\" scrolling=\"no\" frameborder=\"0\"></iframe>\n<script src=\"https://adform.id/embed.js\"></script>"
  }
}

Perhatikan slug di response — belum tentu sama dengan yang Anda kirim, karena bisa ditambah akhiran angka bila bentrok. Selalu pakai slug dan embed.form_url dari response, jangan menebak.

#Validasi harga varian

Bentuk variant_prices diperiksa sebelum disimpan supaya form tidak pernah menagih harga yang salah:

• Satu variasi → variant_prices harus daftar angka datar, bukan bersarang.
• Dua atau tiga variasi → variant_prices harus matriks bersarang yang dimensinya persis sama dengan jumlah opsi tiap variasi, dan setiap sel harus diisi angka lebih dari 0.
• variant_compare_prices, kalau dikirim dan tidak kosong, harus berbentuk sama. Nilai 0 diperbolehkan (artinya tanpa harga coret).
• Setiap variasi minimal punya satu opsi.

Kalau tidak lolos, request dibalas 400 dengan pesan yang menyebutkan masalahnya, misalnya:

{ "error": "variant_prices tiap kombinasi wajib diisi harga lebih dari 0 (ada sel kosong/0)." }

atau

{ "error": "variant_prices bentuk matriks tidak sesuai jumlah opsi variasi." }

#Daftar error

#Yang tidak tersedia di endpoint ini

Supaya tidak ada waktu terbuang: dengan API key, /api/products.php hanya melayani action=embed dan action=duplicate. Tidak ada list produk, ambil detail lengkap, buat produk dari nol, ubah, atau hapus lewat API key. Operasi itu ada di dashboard dan butuh sesi login dashboard.

Kalau Anda butuh salah satunya untuk integrasi, kabari kami lewat Pusat Bantuan — permintaan konkret dari integrator yang menentukan urutan pengerjaan.