Manzzy API Reference

Introduction

Manzzy API menyediakan akses programatik untuk layanan Virtual Number (Nokos). Anda dapat mengintegrasikan API ini ke dalam website, aplikasi, atau bot Telegram/WhatsApp Anda sendiri.

Base URL https://manzzy.web.id/api

Authentication

Semua request membutuhkan API Key yang valid. Sertakan key ini di header Authorization.

                        Header Format
                    
Authorization: Bearer mzy_live_sk_xxxxxxxx

GET

/v1/profile

Mengambil informasi akun dan sisa saldo Anda.

                            
curl -X GET https://manzzy.web.id/api/v1/profile \
  -H "Authorization: Bearer YOUR_API_KEY"
                    
const axios = require('axios');

await axios.get('https://manzzy.web.id/api/v1/profile', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
                    
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://manzzy.web.id/api/v1/profile");
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Bearer YOUR_API_KEY"
));
$res = curl_exec($ch);

GET

/nokos/services

Mendapatkan daftar aplikasi yang tersedia (WhatsApp, Telegram, dll).

Response Example

[
  {
    "service_id": "wa",
    "service_name": "WhatsApp"
  },
  {
    "service_id": "tg",
    "service_name": "Telegram"
  }
]
                    

GET

/nokos/countries

Mendapatkan daftar negara dan harga berdasarkan service ID.

Query Parameters

service_id ID layanan (contoh: 'wa', 'tg')

GET https://manzzy.web.id/api/nokos/countries?service_id=wa

POST

/nokos/buy

Membeli nomor virtual baru. Saldo akan terpotong otomatis.

                            
                            
                        

curl -X POST https://manzzy.web.id/api/nokos/buy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "your_username",
    "service_id": "wa",
    "number_id": "0",
    "provider_id": "1",
    "operator_id": "any"
  }'
                    

const body = {
  username: "User123",
  service_id: "wa",
  number_id: "0", // 0 = Indonesia
  provider_id: "1",
  operator_id: "any"
};

await axios.post('https://manzzy.web.id/api/nokos/buy', body, {
  headers: { 'Authorization': 'Bearer KEY' }
});
                    

Success Response

{
  "success": true,
  "invoiceId": "NOK-174829"
}
                    

GET

/nokos/status/:invoiceId

Gunakan endpoint ini secara berkala (polling) untuk mengecek apakah SMS sudah masuk.

GET https://manzzy.web.id/api/nokos/status/NOK-174829

Response (SMS Received)

{
  "success": true,
  "data": {
    "status": "waiting",
    "phoneNumber": "62812345678",
    "smsCode": "829-102" // Kode OTP Anda
  }
}
                    

POST

/nokos/action

Mengubah status pesanan. Gunakan cancel untuk refund, atau done jika sudah selesai.

Valid Actions

cancel : Batalkan order & refund saldo (jika SMS belum masuk).
resend : Minta SMS ulang (Resend).
done : Tandai selesai.

{
  "username": "User123",
  "invoiceId": "NOK-174829",
  "action": "cancel"
}
                    