Arsitektur Dokumentasi

Mengimpor konten dari platform lain ke Tulis CMS. Saat ini mendukung impor dari WordPress (XML), Strapi (JSON), dan CSV.

Upload WordPress XML

Mengupload file WordPress WXR/XML untuk inspeksi.

Endpoint

POST /api/plugins/importer/upload

Authentication

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

Request

multipart/form-data dengan field file.

Response

{
  "status": 200,
  "message": "File uploaded. Inspecting content...",
  "data": {
    "log_id": "imp_abc123...",
    "total_posts": 42,
    "total_media": 15,
    "ready_to_import": true
  }
}

Import Logs

Melihat riwayat impor yang pernah dilakukan.

Endpoint

GET /api/plugins/importer/logs

Response

{
  "status": 200,
  "data": [
    {
      "id": "imp_abc123...",
      "source": "wordpress",
      "total_imported": 42,
      "status": "completed",
      "created_at": "2026-01-17T10:00:00Z"
    }
  ]
}

Get Import Log Detail

Endpoint

GET /api/plugins/importer/logs/:id

CSV Upload

Upload file CSV untuk inspeksi sebelum impor.

Endpoint

POST /api/plugins/importer/csv/upload

Request

multipart/form-data dengan field file (CSV).

CSV Import

Memulai impor dari file CSV yang sudah diupload.

Endpoint

POST /api/plugins/importer/csv/import

Request Body

{
  "log_id": "imp_xyz789...",
  "column_mapping": {
    "title": "Judul",
    "content": "Konten",
    "status": "Status"
  },
  "post_type": "article"
}

Strapi — Inspect

Menginspeksi endpoint Strapi sebelum impor.

Endpoint

POST /api/plugins/importer/strapi/inspect

Request Body

{
  "url": "https://my-strapi-app.herokuapp.com",
  "api_token": "strapi-api-token...",
  "collection": "articles"
}

Strapi — Import

Memulai impor konten dari Strapi.

Endpoint

POST /api/plugins/importer/strapi/import

Request Body

{
  "url": "https://my-strapi-app.herokuapp.com",
  "api_token": "strapi-api-token...",
  "collection": "articles",
  "post_type": "article",
  "field_mapping": {
    "title": "judul",
    "content": "konten"
  }
}