Dokumentasi API LocalSERP Proxy

Autentikasi

Setiap permintaan selain katalog publik harus menyertakan API key: Authorization: Bearer API_KEY. Key ditampilkan secara lengkap sekali, saat Anda membuatnya: simpan seperti kata sandi. Anda dapat mencabut key kapan saja; permintaan yang menggunakan key tersebut kemudian akan menghasilkan 401 unauthorized.

curl -s "https://localserpproxy.com/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"

Permintaan dan respons

• JSON masuk, JSON keluar: kirim Content-Type: application/json dengan isi permintaan.
• Daftar yang dapat bertambah menggunakan paginasi dengan page (mulai dari 1) dan perPage (1–100, default 20), lalu mengembalikan { "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } }. Daftar pendek mengembalikan { "data": [...] }.
• ID adalah string buram dengan awalan tipe: ord_ (pesanan), top_ (isi saldo), txn_ (pergerakan saldo), res_ (langganan trafik), mob_ (port seluler), key_ (kunci API), dan ipw_ (entri daftar izin IP).
• Coba ulang dengan aman: POST /v1/orders dan POST /v1/topups menerima header Idempotency-Key (string unik apa pun, disimpan selama 24 jam). Mengirim ulang kunci yang sama akan mengembalikan respons pertama, bukan melakukan pembelian atau isi saldo dua kali.
• Contoh menunjukkan format setiap jawaban: ID, IP, jumlah, dan tanggal di dalamnya hanya ilustrasi; ID paket dan harganya adalah yang sebenarnya.

Error

Semua error memiliki isi yang sama. code bersifat tetap dan ditujukan untuk kode Anda; message adalah kalimat dalam bahasa Inggris yang dapat berubah. Error validasi mencantumkan setiap kolom yang tidak valid di fields. Kode baru dapat ditambahkan: tangani kode yang tidak dikenal sebagai kegagalan umum.

{
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": [
      {
        "field": "amountUsd",
        "code": "too_small",
        "message": "The minimum top-up is 25.00 USD."
      }
    ],
    "requestId": "req_2b7c0f"
  }
}

Batas laju

Setiap respons menyertakan RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset. Jika batas terlampaui, API merespons dengan 429 rate_limited dan header Retry-After (detik): tunggu selama waktu tersebut, lalu coba lagi. IP pada port proxy seluler dapat diganti paling sering setiap 30 detik (429 rotation_too_soon, dengan Retry-After).