Storyblok-Wire-Format-Kompatibilität
Die drei Stellen, an denen die API Storyblok byte-genau entspricht, die eine bewusste Abweichung — und die Overflow-Regel, die dich bei Skalierung einholt.
Drei Garantien, auf die das SDK sich verlässt
Bewusste Abweichung: Pagination
Storyblok nutzt per_page=25 als Default. OSSTBlok liefert ohne per_page alle Rows, gedeckelt bei 10000. Die Header per-page und x-total sind immer gesetzt, sodass das SDK so oder so korrekt iteriert. Wer Storybloks Verhalten will, schickt per_page explizit mit.
resolve_relations-Overflow
Werden mehr als 50 eindeutige Relationen aufgelöst, schaltet die Response rels → [] und liefert rel_uuids: [<uuids>]. Clients holen die vollständigen referenzierten Stories per Follow-up (cdn/stories?by_uuids=...). Identisches Verhalten zu Storyblok — SDKs handhaben das automatisch.
json
{
"stories": [...],
"cv": 1714140000,
"rels": [],
"rel_uuids": [
"c3c7e0f3-...",
"b8df1c82-...",
"e71a..."
],
"links": {}
}