> ## 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.
# List Services (Layanan)
> Mendapatkan daftar rekapitulasi lengkap dari semua layanan panel yang berstatus *Active* beserta hitungan biayanya (rate).
Anda dapat menggunakan fungsionalitas di Endpoint canggih ini untuk mem-*fetch* atau mensinkronkan data katalog daftar layanan dari provider pusat sistem kami ke penjelajah panel Anda. Dari sana, Anda dapat menaikkan harganya secara fleksibel (*markup margin/cuan* reseller di web aplikasi Anda), lalu menuangkan katalognya agar bisa dibeli oleh pengguna panel Anda.
Sangat disarankan bagi panel aplikasi developer untuk men-*setting* rutinitas fungsional **Cronjob sinkronisasi database Layanan secara otomatis setidaknya tiap jangka waktu 24 jam sekali** atau seperlunya karena perubahan fundamental pada id provider layanan, status ketersediaan di server inti, update minimum / maksimum (*min*, *max* order capacity), harga fluktuatif (Rate Api) sangat mungkin berubah kapan saja menyesuaikan iklim penyediaan pasokan.
## Query HTTP Parameters
Kunci API Rahasia Anda (Abaikan apabila Anda bertumpu pada penggunaan API HEADER).
(Opsional / Fitur Tambahan) - Filter rentang pencarian hanya menampilkan layanan berdasarkan nama kategori tertentu (Bersifat *case-insensitive*).
(Opsional / Fitur Tambahan) - Mekanisme pencarian teks/String pencocokan dari seluruh baris nama layanan yang ada dari string yang Anda cari secara bebas. (Misal: "followers").
## Skrip Contoh Request Integrasinya
```bash Request Fetch dari Terminal (cURL) theme={null}
curl -X GET -H "X-Api-Key: YOUR_API_KEY_HERE" "https://app.sosmednext.com/api/v1/services"
```
## Referensi Struktur Response Data Format
Respons JSON selalu akan memfasilitasi *List/Array of Data Objects* untuk mendesain keluaran dari seluruh objek layanan *aktif* di server provider kami yang memenuhi kueri *param* Anda.
```json Object JSON Array Output (200 OK) theme={null}
[
{
"service": 1,
"name": "Instagram Followers Terbaik [Quality S+]",
"type": "Default",
"category": "Instagram",
"rate": 15000.0,
"min": 100,
"max": 50000,
"refill": true,
"description": "High quality followers. Garansi drop selama 30 hari. Cepat dan non-drop.",
"cancel": false
},
{
"service": 2,
"name": "TikTok Views Auto Fast Server V1",
"type": "Default",
"category": "TikTok",
"rate": 500.0,
"min": 1000,
"max": 1000000,
"refill": false,
"description": "Masuk sangat instan. Cukup masukkan link Video.",
"cancel": false
}
]
```
### Kamus Penjelasan Lengkap Field / Properti:
Memahami output tipe ini akan amat membantu perancangan pemetaan struktur kolom Tabel/Relasi Database CMS Anda.
| Field Object | Tipe Skrip Data | Keterangan Mutlak Integrasi |
| :------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `service` | Integer | ID Layanan Absolut asli provider di pusat dari infrastruktur kami. (**PERHATIAN HARAP MENYIMPAN NILAI ID INI PADA DATABASE LAYANAN ANDA KARENA HARUS DIOPERKAN SEBAGAI PAYLOAD IDENTIFIKASI `/ORDER` SAAT MELAKUKAN PEMESANAN KELAK!**). |
| `name` | String | Judul/Nama identitas layanan resmi tersebut. |
| `type` | String | Tipe layanan tersebut (contoh: "Default", "Custom Comments", dll). |
| `category` | String | String rumpun fungsional Kategori pengelompokan layanan (seperti Instagram, Youtube, Tiktok) untuk direlasikan pada dropdown daftar layanannya ke user. |
| `rate` | Number | Harga provider termurah / rate layanan **dianalogikan PER hitungan 1000 Pcs Kuantitas / Quantity**. Harga ini telah menyesuaikan formula kalkulasi margin *Rate API Reseller* terbagus untuk kelas role status panel profil Anda secara dinamis dari cloud server admin. |
| `min` | Integer | Validasi limit *Batas Minimal* order kuantitas total yang disediakan server untuk di-push untuk spesifikasi layanan ini. |
| `max` | Integer | Validasi limit maksimal rentang batas order kuantitas untuk layanan ini. (Jangan mengirimkan jumlah di atas batasan ini agar order `/order` Anda tidak diveto penolakan dari server pusat). |
| `refill` | Boolean | Value ini bermaksud apakah order ini menjanjikan kelengkapan / proteksi ber-garansi pemolesan ulang saldo terlepas pasokan target turun/drop (tersedia sistem klaim Refill manual). |
| `description` | String | Textbox deskripsi layanan atau pedoman catatan penting yang menginfokan *term-of-service* aturan server mengenai spesifikasi yang mesti dicermati pengguna web panel reseler sebelum di-*submit* form layanannya, termasuk model isi Link target yang benar dsb. |
| `cancel` | Boolean | Sinyal *boolean* Apakah tombol pembatalan pesanan untuk baris ini diizinkan apabila salah order / panel macet untuk pembatasan *cancel-able server request*. |
**ATURAN MAIN PERHITUNGAN HARGA / ESTIMASI TOTAL BIAYA RATE PESANAN HARGA KE USER (PELANGGAN):**
Tolong cerna konsep ini secara akurat agar Anda terhindar dari keteledoran dan merugi dari sistem Panel web Anda, harap jangan keliru di algoritma aplikasi klien Anda saat pengguna Anda melakukan proses kalkulasi tagihan *checkout order* pembelian!\
Nilai pada json tag `rate` *TIDAK PERNAH MELAMBANGKAN HARGA PER-BIJI (1 ITEM)*, melainkan di API SMM manapun tag itu senantiasa merupakan harga murni dalam standar volume global yaitu **Per Volume 1000 Jumlah Pesanan (Per 1k pcs)**.
**Rumus Utama PHP/NodeJS Teruji Pengkalkulasian Harga Asli Saat Menagih Harga Cuan ke User Tergantung (Customer) Pada Panel Anda secara programatik**:
```javascript theme={null}
/* Contoh Logik Eksekusinya di CMS Anda: */
const TOTAL_HARGA_DASAR = (user_suka_order_quantity / 1000) * provider_API_RATE;
// Anda Tambahkan margin untuk cuan panel anda semisal + Rp 3000
const TOTAL_DITAGIH_POTONG_SALDO_USER = TOTAL_HARGA_DASAR + 3000;
```