Kategori & Brand
Mengambil kategori, brand (merek/operator), dan grup untuk menampilkan atau memfilter produk secara bertahap.
Produk disusun bertingkat: Kategori → Brand → Grup → Produk. Tiga endpoint di halaman ini membantu Anda menampilkan pilihan bertahap (misalnya menu di aplikasi Anda) atau memfilter Daftar Produk.
| Tingkat | Contoh | Keterangan |
|---|---|---|
Kategori | Pulsa, E-Wallet, Game | Jenis layanan. Punya code seperti e-wallet. |
Brand | DANA, Telkomsel, Mobile Legends | Merek atau operator di dalam kategori. Punya code. |
Grup | Reguler, Transfer, Diamond | Varian di dalam brand. Dikenali dengan id. |
Produk | DANA 10.000 | Barang yang dibeli. Lihat Daftar Produk. |
Hanya yang bisa dibeliDaftar di halaman ini hanya memuat kategori, brand, dan grup yang aktif dan berisi minimal satu produk yang dijual lewat API.
1. Daftar kategori
POST
https://api.zevaldigital.com/v1/categoriesMengambil semua kategori.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
secret_id | string | Ya | Secret ID Anda. |
signature | string | Ya | Hasil md5(secret_id:secret_key). Lihat halaman Autentikasi. |
PHP
<?php
$result = zeval('/v1/categories');
foreach ($result['data'] as $category) {
echo $category['code'] . ' - ' . $category['name'] . "\n";
}Node.js
const result = await zeval('/v1/categories');
for (const category of result.data) {
console.log(category.code, '-', category.name);
}Python
result = zeval("/v1/categories")
for category in result["data"]:
print(category["code"], "-", category["name"])Berhasil
HTTP 200
{
"code": 200,
"status": "success",
"message": "Berhasil.",
"data": [
{ "code": "pulsa", "name": "Pulsa" },
{ "code": "e-wallet", "name": "E-Wallet" }
]
}2. Daftar brand
POST
https://api.zevaldigital.com/v1/brandsMengambil brand (merek atau operator). Isi category bila hanya ingin brand dalam satu kategori.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
secret_id | string | Ya | Secret ID Anda. |
signature | string | Ya | Hasil md5(secret_id:secret_key). |
category | string | Tidak | Kode kategori dari endpoint kategori, mis. e-wallet. Kosongkan untuk semua brand. |
PHP
<?php
$result = zeval('/v1/brands', ['category' => 'e-wallet']);
foreach ($result['data'] as $brand) {
echo $brand['code'] . ' - ' . $brand['name'] . "\n";
}Node.js
const result = await zeval('/v1/brands', { category: 'e-wallet' });
for (const brand of result.data) {
console.log(brand.code, '-', brand.name);
}Python
result = zeval("/v1/brands", {"category": "e-wallet"})
for brand in result["data"]:
print(brand["code"], "-", brand["name"])Berhasil
HTTP 200
{
"code": 200,
"status": "success",
"message": "Berhasil.",
"data": [
{
"code": "ewallet-dana",
"name": "DANA",
"category_code": "e-wallet"
}
]
}3. Daftar grup
POST
https://api.zevaldigital.com/v1/groupsMengambil grup (varian) dari sebuah brand, misalnya Reguler atau Transfer.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
secret_id | string | Ya | Secret ID Anda. |
signature | string | Ya | Hasil md5(secret_id:secret_key). |
brand | string | Tidak | Kode brand dari endpoint brand, mis. ewallet-dana. Kosongkan untuk semua grup. |
PHP
<?php
$result = zeval('/v1/groups', ['brand' => 'ewallet-dana']);
foreach ($result['data'] as $group) {
echo $group['id'] . ' - ' . $group['name'] . "\n";
}Node.js
const result = await zeval('/v1/groups', { brand: 'ewallet-dana' });
for (const group of result.data) {
console.log(group.id, '-', group.name);
}Python
result = zeval("/v1/groups", {"brand": "ewallet-dana"})
for group in result["data"]:
print(group["id"], "-", group["name"])Berhasil
HTTP 200
{
"code": 200,
"status": "success",
"message": "Berhasil.",
"data": [
{ "id": 14, "name": "Top Up", "brand_code": "ewallet-dana" }
]
}Menampilkan produk bertahap
- 1Ambil kategoriPanggil
/v1/categoriesuntuk menu utama. - 2Ambil brandSaat pelanggan memilih kategori, panggil
/v1/brandsdengancategorytersebut. - 3Ambil produkSaat memilih brand, panggil
/v1/productsdenganbrand(dangroup_idbila perlu).
Simpan, jangan panggil terus-menerusKategori, brand, dan grup jarang berubah. Simpan hasilnya di server Anda dan perbarui berkala (misalnya setiap beberapa menit sampai satu jam), jangan dipanggil setiap ada pelanggan atau setiap pembelian.