# Content Control API
The Content Control API provides different endpoints to invalidate pages, delete articles or disable ads on certain pages.
The API works both in the live environment and during local development.
All other invalidation methods (MarfeelInsight UI, command line) rely on the API.
# Authentication
All the Content Control API endpoints are secured and only accept POST requests containing a Marfeel secret key.
You must pass the key as a value of the following request header:
mrf-secret-key
Find this key in your MarfeelInsight profile page:
# Invalidate
# Articles
You can invalidate individual articles with the API.
Base URL: https://hublivep.marfeel.com/hub/item/
| Method | Endpoint | Query Parameters |
|---|---|---|
| POST | {TENANT_NAME}/{MARFEEL_NAME}/item.json | ?invalidate=2&uri={URI} |
Where:
| Parameter | Explanation | Example |
|---|---|---|
| TENANT_NAME | The tenant's domain | www.example.com |
| MARFEEL_NAME | The source folder | index |
| URI | The exact article URL to invalidate | http://www.domain.com/news/politics/election-process-casts-doubts-1234567 |
All parameters are mandatory.
Examples:
POST https://hublivep.marfeel.com/hub/item/www.domain.com/index/item.json?invalidate=2&uri=http://www.domain.com/news/politics/election-process-casts-doubts-1234567
POST https://hublivep.marfeel.com/hub/item/www.domain.com/es/item.json?invalidate=2&uri=http://www.domain.com/en/news/champions-league-draw-654321
TIP
Remember to always authenticate the requests.
# Sections
You can invalidate section pages one by one with the Invalidation API.
Base URL: https://hublivep.marfeel.com/
| Method | Endpoint | Query Parameters |
|---|---|---|
| POST | {TENANT_NAME}/{MARFEEL_NAME}/{SECTION_NAME}.json | ?invalidate=1 |
Where:
| Parameter | Explanation | Example |
|---|---|---|
| TENANT_NAME | The tenant's domain | www.example.com |
| MARFEEL_NAME | The source folder | index |
| SECTION_NAME | The "name" of the section to invalidate, as declared in the definition.json | sports |
All parameters are mandatory.
Examples:
POST https://hublivep.marfeel.com/www.domain.com/es/barca.json?invalidate=1
POST https://hublivep.marfeel.com/www.domain.com/index/portada.json?invalidate=1
TIP
Remember to always authenticate the requests.
# Static resources
You can invalidate individual static resources with the Invalidation API.
Base URL: https://hublivep.marfeel.com/hub/mds/
| Method | Endpoint | Query Parameters |
|---|---|---|
| POST | {TENANT_NAME}/{MARFEEL_NAME}/statics | ?uri={URI}&action=invalidate |
Where:
| Parameter | Explanation | Example |
|---|---|---|
| TENANT_NAME | The tenant's domain | www.example.com |
| MARFEEL_NAME | The source folder | index |
| URI | The exact article URL to invalidate | http://www.domain.com/en/news/image.jpg |
Examples:
POST https://hublivep.marfeel.com/hub/mds/www.domain.com/index/statics?uri=http://www.domain.com/news/politics/image.jpg&action=invalidate
POST https://hublivep.marfeel.com/hub/mds/www.domain.com/es/statics?uri=http://www.domain.com/en/news/image.jpg&action=invalidate
TIP
Remember to always authenticate the requests.
# Delete articles
You can delete individual aticles from Marfeel with the Content Control API.
Base URL: https://hublivep.marfeel.com/hub/marfeel/
| Method | Endpoint | Query Parameters |
|---|---|---|
| POST | {TENANT_NAME}/{MARFEEL_NAME}/item.html | ?action=delete&uri={URI} |
Where:
| Parameter | Explanation | Example |
|---|---|---|
| TENANT_NAME | The tenant's domain | www.domain.com |
| MARFEEL_NAME | The source folder | index |
| URI | The exact article URL to delete | http://www.domain.com/en/news/image.jpg |
Examples:
POST https://hublivep.marfeel.com/hub/marfeel/www.domain.com/index/item.html?action=delete&uri=http://www.domain.com/news/politics/article-of-the-day.html
POST https://hublivep.marfeel.com/hub/marfeel/www.domain.com/es/item.html?action=delete&uri=http://www.domain.com/en/news/article-of-the-yesterday.html
TIP
Remember to always authenticate the requests.
# Disable Ads
You can disable ads for a specific article in Marfeel with the Content Control API.
Base URL: https://hublivep.marfeel.com/hub/item/disableAdvertisement
| Method | Endpoint | Query Parameters |
|---|---|---|
| POST | hub/item/disableAdvertisement | ?uri={URI} |
Where:
| Parameter | Explanation | Example |
|---|---|---|
| URI | The exact article URL to disable ads on | https://hublivep.marfeel.com/hub/item/disableAdvertisement?uri=https://domain.com/sports/article-free-of-ads.html |
Examples:
POST https://hublivep.marfeel.com/hub/item/disableAdvertisement?uri=https://domain.com/sports/article-free-of-ads.html
POST https://hublivep.marfeel.com/hub/item/disableAdvertisement?uri=http://domain.com/news/march/article-target-example.html
TIP
Remember to always authenticate the requests.