Dokumentasi API - LapakNomor

Konfigurasi Base URL

https://your-domain.vercel.app/api

Sertakan API Key dalam Header Request Anda untuk mendapatkan hak akses fungsionalitas transaksi:

HTTP Headers

x-api-key: ln-a-fajarganteng12345

GETAmbil Daftar Layanan

/api/rumahotp/services

Mendapatkan daftar semua kode aplikasi yang tersedia di sistem.

Request Headers

Header

x-api-key: YOUR_API_KEY

Response JSON

JSON Response

{
  "success": true,
  "data": [
    {
      "service_code": 13,
      "service_name": "WhatsApp",
      "service_img": "https://assets.rumahotp.io/wa.png"
    }
  ]
}

GETAmbil Daftar Negara

/api/rumahotp/countries?service_id={SERVICE_ID}

Query Parameter

Parameter	Tipe	Wajib	Deskripsi
`service_id`	number	Ya	ID layanan/aplikasi (contoh: `13`)

Response JSON

JSON Response

{
  "success": true,
  "data": [
    {
      "number_id": 340437,
      "name": "Indonesia",
      "img": "https://assets.rumahotp.io/flags/id.png",
      "prefix": "+62",
      "stock_total": 120,
      "pricelist": [
        {
          "provider_id": "3837",
          "price": 1200,
          "price_format": "Rp1.200",
          "stock": 120
        }
      ]
    }
  ]
}

GETBuat Pesanan Nomor

/api/rumahotp/order?number_id={ID}&provider_id={PID}&operator_id={OID}

Query Parameters

Parameter	Tipe	Wajib	Deskripsi
`number_id`	number	Ya	ID Negara tujuan pembelian
`provider_id`	string	Ya	ID Provider dari pricelist
`operator_id`	number	Ya	ID Operator dari daftar operator

Response JSON

JSON Response

{
  "success": true,
  "data": {
    "order_id": "RO0004647717",
    "phone_number": "+6285811223344",
    "service": "WhatsApp",
    "country": "Indonesia",
    "operator": "any",
    "price": 1200,
    "price_formated": "Rp1.200",
    "created_at": 1775020631379,
    "expired_at": 1775021831379
  ]
}

GETCek Status SMS/OTP

/api/rumahotp/order-status?order_id={ORDER_ID}

Query Parameter

Parameter	Tipe	Wajib	Deskripsi
`order_id`	string	Ya	ID pesanan (contoh: `RO0004647717`)

Response JSON (Saat OTP Masuk)

JSON Response

{
  "success": true,
  "data": {
    "order_id": "RO0004647717",
    "status": "completed",
    "phone_number": "+6285811223344",
    "otp_code": "918374",
    "otp_msg": "Kode WhatsApp Anda: 918-374"
  }
}