Shinai Docs

API Documentation

Home

API Documentation

Complete guide to integrate Shinai CDN & URL Shortener into your application

Server Domain

https://shinai.my.id Alternative
https://shinai.onrender.com Recommended

API Endpoints

CDN Upload

/upload

URL Shortener

/shorten

cURL Examples

Basic URL Shortening

POST 
curl -X POST https://shinai.onrender.com/shorten \
-H "x-api-key: sazukaxcmv" \
-H "Content-Type: application/json" \
-d '{"url":"https://google.com"}'

Custom Slug Shortening

POST 
curl -X POST https://shinai.onrender.com/shorten \
-H "x-api-key: sazukaxcmv" \
-H "Content-Type: application/json" \
-d '{"url":"https://google.com", "customId": "optional-custom-id"}'

File Upload to CDN

POST 
curl -X POST https://shinai.onrender.com/upload \
-H "x-api-key: sazukaxcmv" \
-F "file=@awwhh.jpg"

Authentication

API Key Header

x-api-key: sazukaxcmv
sazukaxcmv

Include this header in all your API requests

Response Examples

CDN Upload Response 

{
  "success": true,
  "message": "File berhasil diupload",
  "creator": "NvLabs",
    "data": {
    "id": "r7WOgDlv",
    "filename": "r7WOgDlv.png",
    "originalName": "nv.png",
    "size": 38034,
    "mimeType": "image/png",
    "url": "https://shinai.onrender.com/r7WOgDlv.png",
    "access_url": "https://shinai.onrender.com/r7WOgDlv.png"
  }
}

URL Shortener Response 

{
  "success": true,
  "message": "Short URL berhasil dibuat",
  "creator": "NvLabs",
  "data": {
    "id": "JARrE7",
    "original_url": "https://google.com",
    "short_url": "https://shinai.onrender.com/r/JARrE7",
    "createdAt": "2025-12-06T11:33:07.924Z"
  }
}

2025 Shinai

Made with by Sazuka