PUBLIEKE INHOUD-API

Eenvoudige REST en JSON. Gesluit totdat jy dit oopmaak.

Publieke API-konfigurasie per webwerf beheer presies wat blootgestel word en aan wie. Haal gepubliseerde inhoud, werfkaarte en aanstuurreëls op met oral dieselfde voorspelbare JSON-vorm — geen GraphQL-skema om te leer nie, geen gegenereerde kliënt om gesinkroniseer te hou nie. Elke versoek hieronder is eg: ’n blog gebou op CMSHub, opgeroep met niks behalwe curl nie.

01 / HAAL GEPUBLISEERDE INHOUD OP

Een GET-versoek, gepubliseerde rekords as JSON

Sodra ’n webwerf inteken en ’n versameling op die toelaatlys plaas, is sy gepubliseerde rekords net een gewone GET weg — heeltemal uit die Host-kopskrif opgelos, sonder ’n API-sleutel vir publieke data.

Slegs GEPUBLISEERDE rekords word ooit teruggestuur — konsepte en ongepubliseerde hersienings lek nooit deur die publieke pad nie.
Weier by verstek: ’n onbekende gasheer, ’n gedeaktiveerde webwerf of ’n versameling wat nie op die toelaatlys is nie, gee almal dieselfde 404.
?locale=xx gee daardie taal se gepubliseerde variant terug en val terug op die werkruimte se verstektaal.

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 / ONTDEKKING, OUTOMATIES

’n Werfkaart wat altyd ooreenstem met wat werklik gepubliseer is

sitemap.xml en robots.txt word gegenereer uit dieselfde bladsyvoorraad waaruit die inhoud-API lees — geen aparte konfigurasie om gesinkroniseer te hou nie, en niks om met die hand te hergenereer nie.

Weerspieël die lewendige bladsyvoorraad by elke versoek — publiseer ’n bladsy, en dit is in die werfkaart.
hreflang-alternatiewe word outomaties bygevoeg vir enige bladsy met vertaalde variante.
/robots.txt wys crawlers na dieselfde sitemap, per werf.

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 / BY VERSTEK GESLUIT

Jy besluit wat ’n webwerf blootstel

Publieke inhoud-API’s bly gesluit totdat jy uitdruklik instel wat ’n webwerf blootstel — daar is geen eindpunt wat by verstek oop is en stilweg ongepubliseerde of konsepinhoud bedien nie.

Konfigurasie per webwerf

Aktiveer en konfigureer die publieke API onafhanklik vir elke webwerf in ’n werkruimte.

Slegs gepubliseerde inhoud

Die publieke API bedien wat deur die gehaltehek is en werklik gepubliseer is — nooit konsepte nie.

Met weergawes, stabiel

Elke roete woon onder ’n pad met ’n weergawe, sodat ’n integrasie wat vandag gebou word, aanhou werk soos CMSHub ontwikkel.

GAAN VERDER

ROEP ’N WERKLIKE EINDPUNT OP

Aktiveer die publieke API vir ’n webwerf.

Skakel die publieke inhoud-API aan vir een van jou webwerwe en haal ’n gegenereerde bladsy op.

Maak jou werkruimte oop ↗Terug na Aan die gang ↗