Free tools, open endpoints.

REST API pribadi untuk keperluan developer bot WhatsApp, Telegram, Discord, maupun aplikasi kecil. Dua endpoint publik: brat sticker generator dan TikTok downloader.

§ 01 — endpoints

Yang tersedia

POST

/api/brat

Generate sticker brat dengan emoji Apple HD. Output 1080×1080 PNG.
POST

/api/tiktok

Download video TikTok tanpa watermark, atau seluruh foto dari postingan slide. Metadata lengkap (author, likes, komentar, views) disertakan.
GET

/health

Cek status server. Tanpa autentikasi.

§ 02 — auth

Autentikasi

Semua endpoint /api/* memerlukan API key. Kirimkan lewat header X-API-Key.

X-API-Key: YOUR_API_KEY

Untuk mendapatkan API key, kirim email ke admin@izjtanzala.web.id dengan subject "Request API Key" beserta nama dan tujuan penggunaan.

§ 03 — brat

POST /api/brat

Menghasilkan gambar sticker brat 1080×1080 (PNG) dari teks yang diberikan. Emoji otomatis dirender dengan gaya Apple HD.

body parameters

field	type	wajib	desc
text	string	ya	Maks. 500 karakter.

request

curl -X POST https://api.izjtanzala.web.id/api/brat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"text":"ini yang punya kita 😎🔥"}' \
  --output brat.png

response

200 OK
Content-Type: image/png

(binary PNG, 1080×1080)

error

400  {"error":"Field text wajib diisi"}
401  {"error":"API key diperlukan"}
403  {"error":"API key tidak valid"}
429  {"error":"Terlalu banyak request"}

§ 04 — tiktok

POST /api/tiktok

Deteksi otomatis jenis konten TikTok: video, 1 foto, atau slide multi-foto. Response selalu menyertakan metadata lengkap.

body parameters

field	type	wajib	desc
url	string	ya	URL TikTok (video / photo / short link seperti `vt.tiktok.com`).

request

curl -X POST https://api.izjtanzala.web.id/api/tiktok \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"url":"https://www.tiktok.com/@user/photo/123..."}'

response — video / 1 foto

{
  "type": "video",
  "previewUrl": "/vid-abc123.mp4",
  "message": "Video berhasil diunduh.",
  "metadata": {
    "title": "...",
    "description": "...",
    "author": "Username",
    "authorId": "@username",
    "authorAvatar": "https://...",
    "likes": 12345,
    "comments": 678,
    "shares": 90,
    "views": 543210,
    "duration": 15,
    "music": "Judul musik",
    "thumbnail": "https://..."
  }
}

response — multi slide

{
  "type": "slideshow",
  "slides": [
    { "index": 1, "url": "/slide-abc123/001.jpg" },
    { "index": 2, "url": "/slide-abc123/002.jpg" },
    { "index": 3, "url": "/slide-abc123/003.jpg" }
  ],
  "metadata": { ... }
}

§ 05 — limits

Batasan penggunaan

Rate limit: 20 request / menit / IP. Jika melebihi, akan menerima respons 429 Too Many Requests.

File yang dihasilkan (gambar, video, slide) otomatis dihapus dari server setelah 30 menit. Simpan segera setelah menerima previewUrl.