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-link-checker-broken-links

Broken Link Checker

Memeriksa tautan rusak (broken links) di seluruh konten workspace. Berjalan otomatis sebagai background job dengan interval yang bisa dikonfigurasi.


List Broken Links

Mendapatkan daftar tautan yang terdeteksi rusak.

Endpoint

GET /api/workspaces/:id/broken-links

Authentication

Bearer Token (JWT) + X-Workspace-ID header

Response

{
  "status": 200,
  "data": [
    {
      "id": "lnk_abc123...",
      "url": "https://example.com/deleted-page",
      "status_code": 404,
      "found_in_post": {
        "id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
        "title": "Cara Memulai Blog dengan Tulis CMS"
      },
      "last_checked_at": "2026-01-17T12:00:00Z",
      "failure_count": 3,
      "resolved": false
    }
  ]
}

Check Now

Memulai pemeriksaan broken link secara manual (tidak menunggu scheduler).

Endpoint

POST /api/workspaces/:id/broken-links/check

Authentication

Bearer Token (JWT) + X-Workspace-ID header

Response

{
  "status": 200,
  "message": "Broken link check started. Results will be available shortly.",
  "data": {
    "total_links_checked": 156,
    "broken_found": 2
  }
}

Mark Resolved

Menandai broken link sebagai sudah diperbaiki.

Endpoint

POST /api/workspaces/:id/broken-links/:linkId/resolve

Authentication

Bearer Token (JWT) + X-Workspace-ID header

Response

{
  "status": 200,
  "message": "Broken link marked as resolved"
}

Konfigurasi .env

LINK_CHECK_INTERVAL_HOURS=24   # Interval pengecekan otomatis (default: 24 jam)
BROKEN_LINK_THRESHOLD=5        # Batas kegagalan sebelum dianggap broken (default: 5)

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.