OFFENTLIGT INDHOLDS-API

Ren REST og JSON. Lukket, indtil du åbner.

API-konfigurationen pr. site styrer præcis, hvad der eksponeres, og for hvem. Hent udgivet indhold, sitemaps og redirects i den samme forudsigelige JSON-struktur overalt – intet GraphQL-skema at lære, ingen genereret klient at holde i sync. Hver anmodning nedenfor er ægte: en blog bygget på CMSHub, kaldt med intet andet end curl.

01 / HENT UDGIVET INDHOLD

Én GET-anmodning, udgivne poster som JSON

Når et site har tilvalgt det og godkendt en samling, er dets udgivne poster kun ét simpelt GET-kald væk – afgjort helt ud fra Host-headeren, uden API-nøgle til offentlige data.

Kun UDGIVNE poster returneres nogensinde – kladder og ikke-udgivne revisioner slipper aldrig ud via den offentlige sti.
Afvist som standard: En ukendt host, et deaktiveret site eller en samling, der ikke er godkendt, giver alle 404 på samme måde.
?locale=xx returnerer den udgivne variant på det sprog med fallback til workspacets standardsprog.

GEThttps://the-signal.blog/api/posts

curl https://the-signal.blog/api/posts

RESPONSE

{
  "siteId": "the-signal-4f2a",
  "siteName": "The Signal",
  "baseUrl": "https://the-signal.blog",
  "collection": {
    "id": "3b0d6f2a-9c41-4e8a-8f2e-1d4c9a7b6e11",
    "slug": "posts",
    "name": "Posts"
  },
  "data": [
    {
      "id": "a91f2e3c-7d5b-4a10-9c3e-6f8a2b1d0e44",
      "locale": "en",
      "translationOfId": null,
      "data": {
        "title": "Shipping a public content API without a GraphQL schema",
        "slug": "shipping-a-public-content-api",
        "excerpt": "Plain REST beats a bespoke query language when a frontend just needs JSON.",
        "category": "Engineering",
        "author": "Dana Osei",
        "published_at": "2026-09-10"
      }
    },
    {
      "id": "d2c5b8a1-4e3f-4c9d-8b7a-2f1e6d5c4b33",
      "locale": "en",
      "translationOfId": null,
      "data": {
        "title": "What the quality gate actually checks before you publish",
        "slug": "the-quality-gate-explained",
        "excerpt": "Every generated page passes the same checks, whether it's post 1 or post 10,000.",
        "category": "Product",
        "author": "Dana Osei",
        "published_at": "2026-09-04"
      }
    }
  ],
  "meta": {
    "locale": "en",
    "pagination": { "start": 0, "limit": 20, "total": 2, "nextCursor": null }
  }
}

02 / FINDBARHED, AUTOMATISK

Et sitemap, der altid matcher det, der faktisk er udgivet

sitemap.xml og robots.txt genereres ud fra det samme sidebestand, som indholds-API'et læser fra – ingen separat konfiguration at holde i sync, intet at regenerere i hånden.

Afspejler det live sidebestand ved hver anmodning – udgiv en side, og den er i sitemappet.
hreflang-alternativer tilføjes automatisk for alle sider med oversatte varianter.
/robots.txt peger crawlere til det samme sitemap for hvert site.

GEThttps://the-signal.blog/sitemap.xml

curl https://the-signal.blog/sitemap.xml

RESPONSE

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url><loc>https://the-signal.blog/posts/shipping-a-public-content-api</loc><lastmod>2026-09-10T14:22:00.000Z</lastmod></url>
  <url><loc>https://the-signal.blog/posts/the-quality-gate-explained</loc><lastmod>2026-09-04T09:15:00.000Z</lastmod></url>
</urlset>

03 / LUKKET SOM STANDARD

Du bestemmer, hvad et site eksponerer

Offentlige indholds-API'er forbliver lukkede, indtil du eksplicit bestemmer, hvad et site eksponerer – der er intet endpoint, der står åbent som standard og i det stille leverer ikke-udgivet indhold eller kladder.

Konfiguration pr. site

Aktivér og konfigurér det offentlige API uafhængigt for hvert site i et workspace.

Kun udgivet indhold

Det offentlige API leverer kun det, der har været gennem kvalitetskontrollen og faktisk er udgivet – aldrig kladder.

Versioneret, stabilt

Hver route ligger under en versioneret sti, så en integration bygget i dag bliver ved med at virke, mens CMSHub udvikler sig.

LÆS VIDERE

KALD ET RIGTIGT ENDPOINT

Aktivér det offentlige API for et site.

Slå det offentlige indholds-API til for et af dine sites, og hent en genereret side.

Åbn dit workspace ↗Tilbage til Kom i gang ↗