> ## Documentation Index
> Fetch the complete documentation index at: https://api.sosmednext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Dokumentasi lengkap SosmedNext API v1 untuk integrasi panel SMM Anda.

## Base URL

Semua endpoint API menggunakan base URL berikut:

```
https://app.sosmednext.com/api/v1
```

## Autentikasi

Semua endpoint memerlukan API Key. Anda bisa mengirimkannya melalui:

* **Header** (Rekomendasi): `X-Api-Key: YOUR_API_KEY`
* **Query Parameter**: `?api_key=YOUR_API_KEY`

```bash Contoh menggunakan Header theme={null}
curl -H "X-Api-Key: YOUR_API_KEY" "https://app.sosmednext.com/api/v1/balance"
```

API Key Anda bisa didapatkan dari halaman dashboard akun reseller Anda.

## Endpoint yang Tersedia

| Method | Endpoint                | Deskripsi                         |
| :----- | :---------------------- | :-------------------------------- |
| `GET`  | `/api/v1/services`      | Daftar semua layanan aktif        |
| `POST` | `/api/v1/order`         | Membuat pesanan baru              |
| `GET`  | `/api/v1/status`        | Cek status pesanan (single/multi) |
| `GET`  | `/api/v1/balance`       | Cek saldo akun                    |
| `POST` | `/api/v1/refill`        | Request refill pesanan            |
| `GET`  | `/api/v1/refill_status` | Cek status refill                 |
| `POST` | `/api/v1/cancel`        | Batalkan pesanan                  |

## Format Response

Semua response menggunakan format JSON. Response error akan selalu memiliki field `error`:

```json Response Error theme={null}
{
  "error": "Pesan error di sini"
}
```

## Rate Limiting

Hindari mengirim request terlalu sering. Rekomendasi:

* **Balance check**: Maksimal 1x per menit
* **Status check (cron)**: Setiap 5-15 menit
* **Service sync**: Setiap 24 jam