Autentikasi & API Keys¶
Semua endpoint REST API v1 memakai Bearer API key.
Header¶
Authorization: Bearer nk_<prefix>_<secret>
Membuat API key¶
- Login ke studio.nulis.top
- Buka Integrasi (
/settings/integrations) - Klik Buat key — salin key dari modal (hanya ditampilkan sekali)
Satu key bisa dipakai untuk:
- Plugin WordPress (wizard step 1)
- Custom CMS pull (GET /api/v1/articles)
Scope¶
Default: articles:read
Rate limit¶
120 request per menit per API key.
Response 429 jika melebihi limit:
{ "error": "rate_limited", "message": "Too many requests" }
Contoh¶
export NULIS_API_KEY="nk_xxxx_your_secret"
curl -s -H "Authorization: Bearer $NULIS_API_KEY" \
"https://studio.nulis.top/api/v1/articles?per_page=1"
Keamanan¶
- Jangan commit key ke repository
- Revoke key yang bocor dari halaman Integrasi
- Gunakan key terpisah per environment (staging/production)