Get Sections
How to obtain project sections of a block.
Request
Response
GET https://mburger.cloud/api/blocks/<id>/sections
1
curl https://mburger.cloud/api/blocks/<id>/sections?include=elements&sort=-id&filter[value]=%home,news|paper&skip=0&take=2
2
-H "Accept: application/json"
3
-H "X-MBurger-Token: <token>"
4
-H "X-MBurger-Version: 3"
Copied!

URL Parameters

Name
Type
Required
Description
id
int
Yes
Block id.

Parameters

Name
Type
Required
Description
skip
int
Yes
Specify the number of items to skip for pagination.
take
int
Yes
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.
force_locale_fallback
boolean
No
If true and the requested locale is empty, the fallback locale is returned. Default false.
include
string
No
Specify which relations to load and include in response.
sort
string
No
Specify the sections order.
filter
string
No
Specify filters on sections.
image_format
string
No
Specify which image dimension to include in response. Values are thumb, medium, large and original. Default is medium.
distance
string
No
With this parameter and providing your latitude and longitude the distance between you and every section is added in the response. Example: distance=42.24234,13.543344

Includes

Name
Description
elements
This relation will include all elements of each section.
beacons
This relation will include all beacons associated to each section.

Sort

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

Filters

Name
Exact
Description
id
Yes
You can filter by id, or a list of comma-separated ids.
subscription
No
You can filter sections based on Stripe subscription state. Values are all, active, inactive.
relation
No
You can filter sections based on their relations.
value
No
You can filter only sections that have specific value in their elements. You can pass multiple parameters by passing a comma separated list of values. If you need to filter sections based only on a specific element you can use this syntax element_name|search_string
geofence
No
You can filter only sections that have elements with a location inside a specific geofence. It requires a string of comma-separated coordinate values representing a rectangle of a map, composed as NE latitude, SW latitude, NE longitude, SW longitude.
When successful, a HTTP 200 and JSON like this is returned:
1
{
2
"status_code": 0,
3
"body": {
4
"meta": {
5
"from": 0,
6
"to": 2,
7
"total": 10
8
},
9
"items": [
10
{
11
"id": 1,
12
"order": 1,
13
"all_locales": false,
14
"visible": true,
15
"in_evidence": false,
16
"available_at": 1546599965,
17
"updated_at": 1546599966,
18
"elements": {
19
"title": {
20
"id": 2,
21
"name": "title",
22
"type": "text",
23
"order": 1,
24
"options": null,
25
"locale": "en",
26
"value": "Main Home"
27
},
28
"image": {
29
"id": 3,
30
"name": "image",
31
"type": "image",
32
"order": 2,
33
"options": null,
34
"locale": "en",
35
"value": [
36
{
37
"id": 1,
38
"url": "https://cdn.mburger.cloud/storage/1/conversions/image-medium.jpg",
39
"size": 45166,
40
"mime_type": "image/jpeg"
41
}
42
]
43
},
44
"content": {
45
"id": 4,
46
"name": "content",
47
"type": "textarea",
48
"order": 3,
49
"options": null,
50
"locale": "en",
51
"value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec nisi et sapien tincidunt sodales."
52
}
53
}
54
}
55
]
56
}
57
}
Copied!
Last modified 1yr ago
Copy link