Кlassik dokumentasi dibuat untuk manusia: HTML yang dirender, sorotan sintaks, sidebar, pencarian. Tapi semakin sering yang mengunjungi docs bukan manusia, melainkan agen - Claude, Cursor, ChatGPT - yang justru terganggu oleh semua render ini. Ia membutuhkan teks bersih dan kontrak yang dapat dibaca mesin.
Kami membuat dokumentasi cocok untuk keduanya. Inilah yang ada di balik layar.
.md-duplikat setiap halaman
Section titled “.md-duplikat setiap halaman”Setiap halaman konten dokumentasi memiliki duplikat Markdown mentah dengan jalur yang sama dan sufiks .md. Membuka /agent-setup - ada juga /agent-setup.md, teks yang sama tanpa pembungkus HTML, impor MDX dipotong, disajikan sebagai text/markdown.
Ini memberi dua aksi di menu halaman: Copy as Markdown (menaruh teks bersih ke clipboard, supaya dapat ditempelkan ke chat dengan model) dan View as Markdown (membuka versi .md secara langsung). Agen tidak perlu mem‑parsing DOM - ia mengambil teks siap pakai.
Dropdown aksi di bagian atas halaman
Section titled “Dropdown aksi di bagian atas halaman”Di pojok kanan atas setiap halaman - menu aksi, dibuat khusus untuk alur kerja agen:
- Copy as Markdown - teks bersih halaman ke clipboard
- View as Markdown - membuka duplikat
.md - Open in ChatGPT - mengirim halaman ke ChatGPT dengan satu klik
- Open in Claude - hal yang sama untuk Claude
- Connect MCP - berpindah ke pengaturan server MCP
Alih‑alih “salin URL, buka chat, minta masuk ke halaman” - satu aksi.
llms.txt dan llms-full.txt
Section titled “llms.txt dan llms-full.txt”Menurut standar llmstxt.org kami menyediakan dua file:
/llms.txt- indeks semua halaman dokumentasi, dikelompokkan dalam seksi (API Reference, Use Cases, Examples, Products). Peta untuk agen, dari mana memulai./llms-full.txt- seluruh dokumentasi dalam satu file plain‑text. Untuk pengindeksan offline di basis vektor atau penyisipan sekali ke dalam konteks model.
Jika kamu membangun RAG di atas API kami, llms-full.txt adalah korpus siap pakai, tidak perlu merayapi situs.
Spesifikasi yang dapat dibaca mesin
Section titled “Spesifikasi yang dapat dibaca mesin”Kontrak disediakan dalam beberapa format untuk berbagai alat:
/v1/openapi.json- spesifikasi OpenAPI 3.1 kanonik dengan contoh dan code‑samples. Untuk kodegenerasi klien dan semua tooling OpenAPI.- Swagger-alias -
/v1/swagger.json,/v1/v3/api-docsdan lainnya 301‑redirect ke kanonik, sehingga alat yang mencari jalur biasa tidak tersandung. - Postman-collection -
/postman/astroway-api.jsonuntuk impor ke Postman dengan satu klik.
/agent-setup untuk klien tertentu
Section titled “/agent-setup untuk klien tertentu”Halaman /agent-setup/ - bukan satu panduan umum, melainkan instruksi terpisah untuk tujuh klien: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex. Setiapnya memberikan konfigurasi tepat dan contoh curl tools/list, untuk memeriksa koneksi sebelum menulis kode.
Inline try-it
Section titled “Inline try-it”Di halaman panduan API setiap operasi memiliki widget try-it bawaan: kamu memasukkan sandbox‑key, mengedit body request, menekan «Send» - dan melihat respons nyata tanpa meninggalkan docs. Metode, path, dan contoh body diambil dari curl snippet yang sudah dihasilkan, sehingga widget tidak membuat permintaan tambahan ke openapi.json.
Kenapa semua ini
Section titled “Kenapa semua ini”Intinya sederhana: kalau produkmu adalah API, dokumentasi harus cocok tidak hanya untuk dibaca oleh mata, tapi juga untuk dikonsumsi oleh agen. Setengah integrasi hari ini dimulai dari developer yang membagikan tautan docs ke Claude atau Cursor dan meminta “hubungkan ini”. Kami membuat sehingga di ujungnya ada teks bersih dan kontrak mesin, bukan HTML yang harus diparse.
Coba sendiri: buka halaman docs apa saja, klik menu aksi di kanan atas - dan kamu akan melihat «Open in Claude».
Swiss Ephemeris yang sama dengan Solar Fire - dalam 4 baris kode.
Kunci gratis tanpa kartu. 5.000 panggilan per bulan sebelum pembayaran pertama.