Quickstart

Baca halaman pertama Anda dari ATLAS dalam sekitar lima menit. Anda memerlukan sebuah brand, token baca, dan terminal.

Baca 2 menit

Paket Gratis cukup untuk panduan ini

Semua yang ada di bawah berjalan di paket Gratis dengan satu brand. Tidak perlu kartu kredit.

1 Buka brand Anda

Masuk di dash.atlascms.id lalu buka brand Anda. Brand menyimpan halaman, artikel, media, menu, dan pengaturan satu situs web, dan setiap panggilan API dibatasi ke tepat satu brand. Pilih bahasa penerbitan Anda di Pengaturan, Umum.

2 Buat token baca

Buka Pengaturan, Tim, Token akses lalu buat token berjenis Website (hanya konten yang sudah terbit). Salin sekarang: dashboard menampilkan token sekali saja dan hanya menyimpan hash. Hanya admin yang bisa membuat token baca.

Simpan token di server

Token baca bisa membaca setiap entri yang sudah terbit dari brand. Panggil ATLAS dari server Anda atau dari server route Nuxt, jangan pernah dari kode browser.

3 Ambil halaman dengan curl

Siapkan token baca Anda, lalu minta halaman berdasarkan path-nya ke API di https://api.atlascms.id. Anda hanya akan menerima konten yang sudah terbit.

terminalbash

export ATLAS_TOKEN="atl_read_..."

curl -s "https://api.atlascms.id/v1/public/page?path=/&locale=en" \
  -H "Authorization: Bearer $ATLAS_TOKEN"

4 Baca jawabannya

Halaman dikembalikan di dalam objek data, lengkap dengan block, SEO, tautan ke terjemahannya, dan tema yang merendernya. Path yang tidak dimiliki brand dijawab 404.

response.jsonjson

{
  "data": {
    "id": "01m518vvbf8txh40wcvwhvtzyd",
    "type": "page",
    "locale": "en",
    "path": "/faq",
    "title": "Frequently asked questions",
    "seo": { "title": "FAQ | AtlasCMS", "description": "Answers about plans and the license." },
    "fields": {},
    "terms": [],
    "published_at": "2026-10-16T02:32:40.000000Z",
    "modified_at": "2026-10-21T14:42:20.000000Z",
    "blocks": [ { "id": "atlascms-faq-hero", "type": "atlascms-faq-hero", "v": 1, "props": {} } ],
    "translations": [],
    "fragments": {},
    "route": { "kind": "entry", "template": "page", "candidates": ["page-faq", "page", "singular", "index"] },
    "theme": { "slug": "atlascms", "version": "0.1.0" },
    "fallback": false
  }
}

5 Baca dengan SDK

Klien adalah pembungkus bertipe di sekitar API yang sama. Ia mengirim token Anda, melakukan revalidasi dengan ETag, dan mengembalikan null untuk 404. Paket diterbitkan secara privat ke GitHub Packages di bawah scope @lifefuturedev; tulis ke [email protected] untuk mendapat akses.

page.tstypescript

import { createAtlasClient } from '@atlas/client'

const atlas = createAtlasClient({
  baseUrl: 'https://api.atlascms.id',
  token: process.env.ATLAS_TOKEN!,
})

const page = await atlas.getPage({ path: '/', locale: 'en' })
console.log(page?.title, page?.blocks?.length)

6 Atau render dengan Nuxt

Layer Nuxt menambahkan route catch-all yang meminta halaman dari API pada path yang dikunjungi dan merender block-nya dengan tema Anda. Extend layer tersebut dan atur dua variabel lingkungan.

nuxt.config.tstypescript

export default defineNuxtConfig({
  extends: ['@atlas/nuxt'],
})

Atur lingkungan

Taruh NUXT_ATLAS_API_URL dan NUXT_ATLAS_TOKEN di .env. Panduan layer Nuxt mencantumkan setiap key.

7 Segarkan situs saat Anda menerbitkan

Tambahkan webhook di Pengaturan, Penerbitan, Hooks yang mengarah ke situs Anda. ATLAS menandatangani setiap pesan, sehingga situs bisa memeriksa tanda tangan sebelum membersihkan cache-nya. Panduan webhook memuat detail dan contoh verifikasi.

Apakah halaman ini membantu?

Usulkan perubahan

BerikutnyaKonsep inti