Tulis Logotulis
Dokumentasi Resmi
|tulis.org

Arsitektur Dokumentasi

Peta jalan panduan, SDK integration, dan API reference lengkap yang disiapkan secara terstruktur.

TULIS CMS/DEVELOPER HUB
/api-reference-api-keys-manage

API Keys

Mengelola kunci API untuk mengakses Public API v1. Setiap workspace bisa memiliki beberapa API key. Hanya role editor ke atas yang bisa mengelola.

Generate API Key

Membuat API key baru. Key hanya ditampilkan sekali — simpan segera setelah dibuat.

Endpoint

POST /api/api-keys

Authentication

Bearer Token (JWT) + X-Workspace-ID header · Role: editor+

Request Body

FieldTypeRequiredDescription
namestringyaNama deskriptif (contoh: "Next.js Frontend").
{
  "name": "Next.js Frontend"
}

Response

{
  "status": 201,
  "message": "API key generated. Save this key now — you won't see it again.",
  "data": {
    "id": "key_abc123...",
    "name": "Next.js Frontend",
    "key": "tulis_live_abc123def456ghi789...",
    "created_at": "2026-01-17T10:00:00Z"
  }
}

⚠️ PENTING: Field key hanya muncul sekali. Jika hilang, Anda harus membuat key baru (revoke + generate ulang).

List API Keys

Mendapatkan daftar API key (tanpa nilai key-nya).

Endpoint

GET /api/api-keys

Authentication · Role: editor+

Response

{
  "status": 200,
  "data": [
    {
      "id": "key_abc123...",
      "name": "Next.js Frontend",
      "last_used_at": "2026-01-17T11:00:00Z",
      "created_at": "2026-01-17T10:00:00Z"
    },
    {
      "id": "key_def456...",
      "name": "Mobile App",
      "last_used_at": null,
      "created_at": "2026-01-16T08:00:00Z"
    }
  ]
}

Revoke API Key

Menonaktifkan API key (tidak bisa digunakan lagi).

Endpoint

PUT /api/api-keys/:id

Authentication · Role: editor+

Response

{
  "status": 200,
  "message": "API key revoked"
}

Delete API Key

Menghapus API key secara permanen.

Endpoint

DELETE /api/api-keys/:id

Authentication · Role: editor+

Response

{
  "status": 200,
  "message": "API key deleted"
}

Lini Masa Peluncuran Fitur

Fase 1: Setup Awal & KonfigurasiSELESAI

Docker Compose, pengaturan file environment, dan panduan setup lokal telah lengkap dibuat.

Fase 2: Referensi RESTful APISELESAI

Dokumentasi route endpoint publik, otentikasi JWT, dan kontrol hak akses telah selesai disusun.

Fase 3: Integrasi Frontend & Fitur LanjutSEDANG BERJALAN

Mempersiapkan boilerplate untuk Next.js client, manajemen revisi konten, dan optimasi query.