ONLym-Api.

Platfrom dokumentasi API Interaktif dengan berbagai fitur Artificial Intellegence, Downloader, Maker, dan berbagai Tools lainnya!

GUEST IDENTITY

UNAUTHENTICATED

Tamu / Pengunjung

Free Tier Ready

Masuk akun untuk mendapatkan APIKey Master, kuota harian gratis, dan akses 200+ endpoint.

300 Hit Limit Gratis

200+ Endpoint Aktif

Instan APIKey Master

Memuat...

API PROTOCOL & TELEMETRY

HTTP Status Codes Reference

Dokumentasi lengkap standar kode respons HTTP (2xx, 3xx, 4xx, 5xx) dan struktur baku pesan JSON untuk integrasi bot & aplikasi Anda.

2xx

Sukses (Success)

Permintaan berhasil diterima, dipahami, dan diproses oleh server.

Kode	Status	Keterangan	Contoh Penggunaan
200	`OK`	Permintaan berhasil diproses secara normal.	Ambil data (`GET`), update data sukses.
201	`Created`	Permintaan berhasil dan data/resource baru selesai dibuat.	Registrasi akun baru, upload file baru (`POST`).
204	`No Content`	Berhasil diproses, tetapi tidak ada respon body yang dikembalikan.	Hapus data sukses (`DELETE`).

3xx

Pengalihan (Redirection)

Klien perlu melakukan aksi tambahan untuk menyelesaikan permintaan.

Kode	Status	Keterangan	Contoh Penggunaan
301	`Moved Permanently`	Alamat endpoint sudah dipindahkan secara permanen ke URL baru.	Migrasi rute API ke versi baru.
304	`Not Modified`	Data belum berubah sejak request terakhir (cache valid).	Penggunaan cache browser/klien untuk menghemat kuota request.

4xx

Kesalahan Klien (Client Error)

Permintaan gagal karena kesalahan dari sisi klien (parameter hilang, kuota habis, dll).

Kode	Status	Keterangan	Contoh Penggunaan
400	`Bad Request`	Format request tidak valid, parameter wajib hilang, atau JSON rusak.	Parameter query `url` atau `prompt` kosong.
401	`Unauthorized`	Permintaan ditolak karena tidak ada kredensial autentikasi.	Lupa memasukkan `apikey` atau token kedaluwarsa.
403	`Forbidden`	Kredensial valid, tapi akun tidak punya izin mengakses fitur ini.	User free mencoba akses endpoint VIP / tier berbayar.
404	`Not Found`	Endpoint atau data yang dicari tidak ditemukan di server.	Salah ketik URL rute API, ID data tidak ada di database.
413	`Payload Too Large`	Ukuran file yang diunggah melebihi batas kuota tier akun.	Upload file >10MB untuk user Free atau >50MB untuk VIP.
429	`Too Many Requests`	Melewati batas limit permintaan (rate limit) atau kuota habis.	Spam request terlalu cepat, kuota harian tier pengguna habis.

5xx

Kesalahan Server (Server Error)

Server mengalami kendala teknis saat memproses permintaan.

Kode	Status	Keterangan	Contoh Penggunaan
500	`Internal Server Error`	Terjadi eror tak terduga pada sistem backend.	Unhandled exception di kode aplikasi, query database eror.
502	`Bad Gateway`	Server gateway menerima respons tidak valid dari upstream.	Worker mati di belakang reverse proxy Nginx/Cloudflare.
503	`Service Unavailable`	Server sedang overload atau dalam pemeliharaan (maintenance).	Server sedang deploy berkala atau kuota upstream habis.
504	`Gateway Timeout`	Server kehabisan waktu menunggu respons dari backend target.	Website target yang di-scrape lambat atau IP proxy timeout.

Standar Format Respon JSON (Best Practice)

Format respons seragam di seluruh endpoint ONLym-Api antara status sukses dan gagal untuk mempermudah integrasi.

Contoh Format Sukses (200 OK)

{
  "status": true,
  "code": 200,
  "creator": "onlym.my.id",
  "message": "Success",
  "result": {
    "username": "user123",
    "tier": "VIP",
    "quota_remaining": 950
  }
}

Contoh Format Gagal (400 / 401 / 429)

{
  "status": false,
  "code": 401,
  "creator": "onlym.my.id",
  "message": "Apikey tidak valid atau telah kedaluwarsa."
}