Links

Get Blocks

How to obtain project blocks.
Request
Response
GET https://mburger.cloud/api/blocks
curl https://mburger.cloud/api/blocks?include=sections&sort=-title&filter[title]=%home,news
-H "Accept: application/json"
-H "X-MBurger-Token: <token>"
-H "X-MBurger-Version: 3"

Parameters

Name
Type
Required
Description
skip
int
No
Specify the number of items to skip for pagination.
take
int
No
Specify the number of items to get for pagination.
locale
string
No
For multilanguage projects specify the desired locale for elements values. If locale is not provided or found the project fallback will be used.
include
string
No
Specify which relations to load and include in response.
sort
string
No
Specify the blocks order.
filter
string
No
Specify filters on blocks.
image_format
string
No
Specify which image dimension to include in response. Values are thumb, medium, large and original. Default is medium.
force_locale_fallback
boolean
No
If true and the requested locale is empty, the fallback locale is returned. Default false.

Includes

Name
Description
sections
This relation will include all sections of each block. You can also send sections.elements to also obtain all the elements of every section in a single API call. Note that this will impact the performance.
structure
This relation will include all elements that define the structure of block.

Sort

Name
Default
Description
id
Yes
Sort by id.
title
No
Sort by title field.
order
No
Sort by order field.

Filters

Name
Exact
Description
id
Yes
You can filter by id.
title
No
You can filter by title.
When successful, a HTTP 200 and JSON like this is returned:
{
"status_code": 0,
"body": {
"meta": {
"from": 0,
"to": 2,
"total": 2
},
"items": [
{
"id": 2,
"order": 1,
"title": "News",
"subtitle": null,
"url_title": "news",
"is_single": false,
"sections": [
{
"id": 1,
"order": 1,
"all_locales": true,
"visible": true,
"in_evidence": false,
"available_at": 1543395018,
"updated_at": 1546599688
},
{
"id": 2,
"order": 2,
"all_locales": true,
"visible": true,
"in_evidence": false,
"available_at": 1543395063,
"updated_at": 1546599688
}
]
},
{
"id": 1,
"order": 1,
"title": "App Home",
"subtitle": null,
"url_title": "app-home",
"is_single": false,
"sections": [
{
"id": 3,
"order": 3,
"all_locales": true,
"visible": true,
"in_evidence": false,
"available_at": 1543395081,
"updated_at": 1546599688
}
]
}
]
}
}
​
Last modified 2yr ago