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
.