The Pages API allows you to manage content pages in your store. This guide provides examples for each endpoint with sample requests and responses.
https://www.venddor.com.br/api/2.0
Retrieves a list of pages with their properties.
curl -X GET 'https://www.venddor.com.br/api/2.0/pages'
Retrieves details of a specific page by its ID.
| Parameter | Type | Description |
|---|---|---|
| id* | integer | The unique identifier of the page |
curl -X GET 'https://www.venddor.com.br/api/2.0/pages/1'
page_id=1.
Creates a new page in the system.
Required fields: page_type*, page*
Available fields: page_type, page, parent_id, status, position, usergroup_ids, localization, new window (for links only), use_avail_period, avail_from_timestamp, avail_till_timestamp, description, meta_keywords, meta_description, page_title, link (only for links), seo_name
| Status Code | Description |
|---|---|
201 Created |
Page created successfully |
400 Bad Request |
Invalid request parameters |
curl --header 'Content-type: text/plain' -X POST 'https://www.venddor.com.br/api/2.0/pages' --data-binary 'page_type=T&page=Test Page&status=H&description=<p>This is a test page to see how the API works.</p>'
This example creates a new hidden page called Test Page with the following content: "This is a test page to see how the API works.". The content uses HTML <p></p> tags.
{
"page_id": 226
}
Updates an existing page with new properties.
| Parameter | Type | Description |
|---|---|---|
| id* | integer | The unique identifier of the page to update |
page, parent_id, status, position, timestamp, usergroup_ids, localization, new window (for links only), use_avail_period, avail_from_timestamp, avail_till_timestamp, description, meta_keywords, meta_description, page_title, link (only for links), seo_name
curl --header 'Content-type: text/plain' -X PUT 'https://www.venddor.com.br/api/2.0/pages/226' --data-binary 'status=A'
This example updates the status of the page with page_id=226 to Active.
{
"page_id": 226
}
Deletes a specific page from the system.
| Parameter | Type | Description |
|---|---|---|
| id* | integer | The unique identifier of the page to delete |
| Status Code | Description |
|---|---|
204 No Content |
Page deleted successfully |
400 Bad Request |
Page couldn't be deleted |
404 Not Found |
Page doesn't exist |
curl -X DELETE 'https://www.venddor.com.br/api/2.0/pages/226'
This example deletes the page with page_id=226.