Skip to content
P
API for partners
Connecting your application — access, authentication and endpoints
Endpoint reference / Blog

Blog — site content#

The most open module — most reading is public.

Every resource offers the standard set of actions

get, get-by, get-all, save, update-columns, delete, delete-all — unless stated otherwise. See the CRUD pattern.

Resources#

Resource Note
article article — public, event
news news item — public
event dated event — public
category category — tree, public
tag tag — public
gallery gallery
carousel rotating content
intro intro block
flash-message site announcement
guestbook guestbook — public
guestbook-message guestbook entry
contact-message contact form message
article-discussion-message post in an article discussion

Articles#

The most used resource of the whole API. Reading is public.

/api/blog/article/get-all?limit=10&computeTotalCount=1&includes[]=translations

Without includes[]=translations you get no text

The title and body are in a subordinate entity, one per language.

Multiple languages#

Texts live in translations. The language is chosen by the address prefix (/en/api/…) or by a filter over the translations.

An empty translation is not a missing translation

A stored empty text counts as valid and the fallback language is not used. The item then comes out with no name.

Events#

An event carries a date, a place and possibly admission.

Filter by date, not by an active flag

Past events stay in the data.

Guestbook#

Writing is open to visitors who are not signed in, but an entry usually waits for approval.

Do not publish personal details to the guestbook

It is public. A phone number or order number there is readable by anybody.