API Documentation

API Reference

41 endpoints across 10 categories. Everything you need to integrate.

Getting Started

Welcome to StarNova API! Follow these steps:

  1. 1Create an account at Register
  2. 2Generate an API key from your dashboard
  3. 3Include your API key in the X-API-Key header
  4. 4Start making requests to our endpoints!

Base URL

https://api.starnova.my.id/api/v1

Authentication

StarNova API uses two authentication methods:

API Key

For API endpoints:

X-API-Key: snv_your-key-here

JWT Token

For dashboard/user endpoints:

Authorization: Bearer your-jwt-token

Authentication(7 endpoints)

POST
/auth/register

Register a new user account

201
POST
/auth/login

Login with credentials

200
POST
/auth/refresh

Refresh JWT token

200
POST
/auth/forgot-password

Request password reset

200
POST
/auth/reset-password

Reset password with token

200
GET
/auth/profile

Get current user profile

200
POST
/auth/logout

Logout user

200

API Keys(7 endpoints)

GET
/apikeys

Get all API keys for user

200
POST
/apikeys

Create new API key

201
GET
/apikeys/:id

Get API key by ID

200
PUT
/apikeys/:id

Update API key

200
DELETE
/apikeys/:id

Delete API key

200
PATCH
/apikeys/:id/toggle

Toggle API key active status

200
POST
/apikeys/:id/regenerate

Regenerate API key

200

AI(2 endpoints)

POST
/ai/chat

AI Chat completion

200
POST
/ai/generate

AI Text generation

200

Downloader(3 endpoints)

POST
/downloader/tiktok

Download TikTok video

200
POST
/downloader/youtube

Download YouTube video/audio

200
POST
/downloader/instagram

Download Instagram content

200

Search(2 endpoints)

GET
/search/web

Search the web

200
GET
/search/images

Search images

200

Image(2 endpoints)

POST
/image/analyze

Analyze image content

200
POST
/image/convert

Convert image format

200

Text(3 endpoints)

POST
/text/summarize

Summarize text content

200
POST
/text/translate

Translate text

200
POST
/text/detect-language

Detect text language

200

Utility(3 endpoints)

POST
/utility/qrcode

Generate QR code

200
POST
/utility/shorten

Shorten a URL

200
GET
/utility/weather

Get weather information

200

Brat(1 endpoints)

POST
/brat/generate

Generate Brat-style text/image

200

Admin(11 endpoints)

GET
/admin/stats

Get dashboard statistics

200
GET
/admin/users

Get all users

200
GET
/admin/users/:id

Get user detail

200
POST
/admin/users/:id/ban

Ban a user

200
POST
/admin/users/:id/unban

Unban a user

200
GET
/admin/apikeys

Get all API keys

200
GET
/admin/analytics

Get analytics data

200
GET
/admin/settings

Get system settings

200
POST
/admin/settings

Update system setting

200
POST
/admin/maintenance

Toggle maintenance mode

200
GET
/admin/logs

Get system logs

200