API Reference

JVTO OKF API

Read-only JSON API exposing JVTO's public OKF bundle content. No authentication required, CORS is open, and every response is JSON.

https://okf.javavolcano-touroperator.com

Endpoints

GET /healthz

Health check.

Request
curl https://okf.javavolcano-touroperator.com/healthz
Response
{ "ok": true }
GET /api/travel-guides

List every travel guide (id, title, description, tags, status, last_verified).

Request
curl https://okf.javavolcano-touroperator.com/api/travel-guides
Response
[
  {
    "id": "travel-guides/best-time-to-visit",
    "title": "Best Time to Visit East Java",
    "description": "When to go — the dry season gives the clearest ...",
    "tags": ["travel-guide", "planning", "season", "weather"],
    "status": "reviewed",
    "last_verified": "2026-06-23"
  },
  ...
]
GET /api/travel-guides/:slug

One guide's full frontmatter plus markdown body. Accepts a bare slug (best-time-to-visit) or the full catalog id (travel-guides/best-time-to-visit).

Request
curl https://okf.javavolcano-touroperator.com/api/travel-guides/best-time-to-visit
Response
{
  "type": "Travel Guide",
  "title": "Best Time to Visit East Java",
  "status": "reviewed",
  "last_verified": "2026-06-23",
  ...
  "body": "# Overview\n\nThere is no universally bad time to visit ..."
}