Dokumentasi RESTful API & Webhook MenoriGadget

1. Otentikasi (Authentication)

Semua pemanggilan API ke endpoint /api/v1/* wajib menyertakan API Key. Anda dapat mengirimkan token melalui header:

Authorization: Bearer mg_live_YOUR_API_KEY_HERE

Atau alternatifnya menggunakan header X-API-KEY: mg_live_YOUR_API_KEY_HERE.

2. Kategori Gadget

Saat mengirim artikel baru, parameter category dapat diisi berupa slug string atau ID kategori:

Endpoint utama yang dipanggil oleh Hermes Agent untuk mempublikasikan artikel ulasan gadget baru.

Parameter Body (JSON)

Contoh JSON Payload Request:

{
  "title": "Review Google Pixel 9 Pro: Standar Baru Fotografi Komputasional & AI On-Device",
  "product_name": "Google Pixel 9 Pro",
  "brand": "Google",
  "category": "smartphone",
  "price": "Rp 17.999.000",
  "price_range": "flagship",
  "verdict_badge": "Editor's Choice",
  "image_url": "https://images.unsplash.com/photo-1598327105666-5b89351aff97?q=80&w=800",
  "summary": "Google Pixel 9 Pro menghadirkan lompatan signifikan pada stabilitas chipset Tensor G4, panel OLED super terang 3000 nits, dan integrasi fitur AI Gemini Nano yang sangat mulus.",
  "content": "<h3>1. Desain & Kualitas Bodi</h3><p>Google mengubah bahasa desain dengan bingkai datar yang solid...</p><h3>2. Kemampuan Kamera</h3><p>Sensor 50MP utama menangkap detail bayangan luar biasa...</p><h3>Kesimpulan</h3><p>Pilihan terbaik untuk pecinta fotografi mobile murni.</p>",
  "pros": [
    "Kamera telefoto 5x periskop sangat tajam",
    "Dukungan pembaruan OS Android selama 7 tahun",
    "Layar Super Actua OLED 3000 nits sangat nyaman di luar ruangan"
  ],
  "cons": [
    "Kecepatan pengisian daya 27W tergolong lambat di kelasnya",
    "Harga resmi varian 256GB cukup tinggi"
  ],
  "specs": {
    "Layar": "6.3 inch Super Actua LTPO OLED 120Hz 3000 nits",
    "Chipset": "Google Tensor G4 (4nm) dengan Titan M2",
    "RAM & Storage": "16GB RAM, 128GB / 256GB UFS 3.1",
    "Kamera": "50MP Utama + 48MP Ultrawide + 48MP Telefoto 5x",
    "Baterai": "4700 mAh fast charging 27W & Qi Wireless",
    "OS": "Android 15 murni (7 tahun update)"
  },
  "author_name": "Hermes AI Agent",
  "is_featured": 1
}

Memperbarui artikel review yang sudah ada. Cukup sertakan parameter yang ingin diubah.

{
  "summary": "Pembaruan ulasan setelah 3 bulan rilis: Efisiensi baterai dan manajemen termal meningkat.",
  "content": "<h3>Pembaruan Ulasan</h3><p>Konten yang diperbarui oleh Hermes Agent...</p>"
}

Mengambil daftar ulasan dengan dukungan query parameter:

• ?page=1 : Nomor halaman
• ?limit=20 : Batas artikel per halaman (maksimal 100)
• ?search=pixel : Pencarian kata kunci pada judul / produk
• ?category=smartphone : Filter berdasarkan kategori

Menerima perintah aksi langsung (action-driven) dari Hermes Agent:

{
  "action": "create_review",
  "data": {
    "title": "Review ASUS Zenbook S 14: Laptop AI Paling Tipis",
    "category": "laptop",
    "summary": "Bodi keramik Ceraluminum yang elegan dengan daya tahan baterai hingga 18 jam.",
    "content": "<p>Ulasan lengkap ASUS Zenbook S 14...</p>",
    "price": "Rp 27.999.000",
    "author_name": "Hermes AI Agent"
  }
}

7. Outbound Webhook Notifier (MenoriGadget ke Hermes Agent)

MenoriGadget dapat mengirimkan HTTP POST otomatis ke server Anda setiap kali artikel baru diterbitkan atau diubah.

Header Pengiriman Webhook:

• X-Menori-Event : Nama event (review.created, review.updated, review.deleted)
• X-Menori-Delivery : ID unik pengiriman untuk deduplikasi
• X-Menori-Signature : Hash HMAC-SHA256 untuk memverifikasi keaslian payload

8. Contoh Script Python untuk Hermes Agent

Kode Python siap pakai untuk dieksekusi di pipeline Hermes Agent:

import requests

API_URL = "https://gadget.menorishop.com/api/v1/reviews"
API_KEY = "mg_live_YOUR_API_KEY_HERE"  # Ganti dengan API Key rahasia dari Panel Admin

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "title": "Review Xiaomi 15 Pro: Flagship Monster Snapdragon 8 Elite",
    "product_name": "Xiaomi 15 Pro",
    "brand": "Xiaomi",
    "category": "smartphone",
    "price": "Rp 13.999.000",
    "image_url": "https://images.unsplash.com/photo-1598327105666-5b89351aff97?q=80&w=800",
    "summary": "Performa Snapdragon 8 Elite dengan baterai raksasa 6100 mAh dalam bodi ramping.",
    "content": "<h3>Ulasan Lengkap</h3><p>Kamera Leica Summilux menghasilkan dynamic range menakjubkan...</p>",
    "pros": ["Baterai 6100 mAh super awet", "Layar 2K OLED 3200 nits", "Kamera Leica tajam"],
    "cons": ["Kamera telefoto sedikit tebal", "Harga naik dibanding generasi sebelumnya"],
    "specs": {
        "Layar": "6.73 inch LTPO OLED 120Hz",
        "Chipset": "Snapdragon 8 Elite (3nm)",
        "Baterai": "6100 mAh 90W HyperCharge"
    },
    "author_name": "Hermes AI Agent"
}

response = requests.post(API_URL, json=payload, headers=headers)
print("HTTP Status:", response.status_code)
print("Result JSON:", response.json())