Information

Standar API

Prinsip umum

• REST API
• versioned API
• response format konsisten
• pagination standar
• filter/sort/search standar
• admin API dipisahkan secara jelas
• API harus aman untuk konsumsi frontend publik dan admin panel

Prefix route

Contoh:

/api/v1/auth/*
/api/v1/profile/*
/api/v1/contents/*
/api/v1/movies/*
/api/v1/series/*
/api/v1/anime/*
/api/v1/videos/*
/api/v1/short-dramas/*
/api/v1/k-dramas/*
/api/v1/manga/*
/api/v1/novels/*
/api/v1/search/*
/api/v1/watch/*
/api/v1/comments/*
/api/v1/reviews/*
/api/v1/watchlists/*
/api/v1/plans/*
/api/v1/subscriptions/*
/api/v1/pages/*
/api/v1/news/*
/api/v1/notifications/*
/api/v1/admin/*

Response success

{
  "success": true,
  "message": "Request successful",
  "data": {},
  "meta": {},
  "errors": null
}

Response error

{
  "success": false,
  "message": "Validation failed",
  "data": null,
  "meta": null,
  "errors": {
    "field": ["Error message"]
  }
}

Pagination format

Gunakan struktur pagination konsisten pada semua list endpoint. Minimal meta:

• current_page
• per_page
• total
• last_page
• from
• to

Filter & Sort standard

• page
• per_page
• search
• sort_by
• sort_direction
• status
• type
• genre
• tag

Logging & Audit

Logging minimal

• app log
• auth log
• API error log
• job log
• media processing log

Audit log wajib untuk

• create/update/delete content
• publish/unpublish
• role/permission changes
• settings changes
• moderation actions
• plan/subscription changes
• admin login penting

Aturan:

• audit log harus menyimpan siapa melakukan apa, kapan, terhadap data apa;
• gunakan snapshot before/after untuk aksi perubahan penting.