Get Services & Categories
Get all services, for each category for a given Storefront domain
In order to get available services and categories using Centili Storefront Content API v1, you need to send an HTTP GET request with a domain name.
Before initiating a get services request you will need to obtain an access token
GET Services & Categories request
URL to which a request should be sent
https://capi.centili.com/content/v1/services
https://capi.centili.com/content/v1/services?domain={domain}
Host: capi.centili.com:443
Authorization: bearer token
Request parameters
Parameter | Description | Example | Required as |
---|---|---|---|
domain | A Storefront domain name for which the services and categories are retrieved | store-demo.centili.com | mandatory |
GET Services & Categories response
200
Obtained service categories for a domain
Response example
[
{
"categoryName": "Gaming",
"services": [
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/388e8ff1fd2db5c2c644562e697fd0f1.png?v=77",
"name": "Fortnite",
"merchant": "Demo Storefront",
"description": "Fortnite is a survival game where 100 players fight against each other in player versus player combat to be the last one standing. It is a fast-paced, action-packed game, not unlike The Hunger Games, where strategic thinking is a must in order to survive.",
"serviceKey": "388e8ff1fd2db5c2c644562e697fd0f1"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/e259a3f09b93d32d494b394ba9a9eb7e.png?v=77",
"name": "Mobile Legends",
"merchant": "Demo Storefront",
"description": "Gameplay. Mobile Legends: Bang Bang is a multiplayer online battle arena (MOBA) game designed for mobile phones. The game is free-to-play and is only monetized through in-game purchases like characters and skins. Each player can control a selectable character, called βHeroβ, with unique abilities and traits.",
"serviceKey": "e259a3f09b93d32d494b394ba9a9eb7e"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/3fcc8b7821f547ac2774b1a6c12616de.png?v=77",
"name": "Playstation",
"merchant": "Demo Storefront",
"description": "Explore PlayStation Store from your console, smartphone or web browser and discover a treasure trove of games β from triple-A blockbusters to indie gems β as well as add-ons and season passes. With regular sales, promotions and extra savings for PlayStation Plus members, there's always one more adventure waiting.",
"serviceKey": "3fcc8b7821f547ac2774b1a6c12616de"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/cb976e00afbd109eaf5b4b77c72eb8fb.png?v=77",
"name": "PubG",
"merchant": "Demo Storefront",
"description": "Gameplay. PUBG is a player versus player shooter game in which up to one hundred players fight in a battle royale, a type of large-scale last man standing deathmatch where players fight to remain the last alive. Players can choose to enter the match solo, duo, or with a small team of up to four people.",
"serviceKey": "cb976e00afbd109eaf5b4b77c72eb8fb"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77",
"name": "XBox ",
"merchant": "Demo Storefront",
"description": "Xbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices.",
"serviceKey": "a015bd48b95345cba6ee4ba8e84d7256"
}
]
},
{
"categoryName": "Video",
"services": [
]
},
{
"categoryName": "Music",
"services": [
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/4e156f1034fe7816498db1b072af7d9a.png?v=77",
"name": "Deezer",
"merchant": "Demo Storefront",
"description": "Deezer is a French online music streaming service. It allows users to listen to music content from record labels, as well as podcasts on various devices online or offline.\n<br><br>\nCreated in Paris, Deezer currently has 90 million licensed tracks in its library, with over 30,000 radio channels, 100 million playlists, 16 million monthly active users, and 7 million paid subscribers as of January 2019.[4][5]\n<br><br>\nThe service is available for Web, Android, iOS, Windows Mobile, BlackBerry OS, Windows, and MacOS.",
"serviceKey": "4e156f1034fe7816498db1b072af7d9a"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/19ef4f9c004211340556e99c8c185c6b.png?v=77",
"name": "Spotify ",
"merchant": "Demo Storefront",
"description": "Spotify is a digital music, podcast, and video service that gives you access to millions of songs and other content from creators all over the world. ",
"serviceKey": "19ef4f9c004211340556e99c8c185c6b"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/f35c15da5568c531dd19e8d2fba91588.png?v=77",
"name": "StingRay ",
"merchant": "Demo Storefront",
"description": "Stingray is the world leading music service provider offering the best music for every moment: discover Stingray Music, Karaoke, and more!",
"serviceKey": "f35c15da5568c531dd19e8d2fba91588"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/MUSIC/47e52312d4efbc0a0e88a58fdd4a06ff.png?v=77",
"name": "Tidal ",
"merchant": "Demo Storefront",
"description": "TIDAL is a global music streaming platform bringing fans closer to artists through unique experiences and the highest sound quality.",
"serviceKey": "47e52312d4efbc0a0e88a58fdd4a06ff"
}
]
},
{
"categoryName": "Education",
"services": [
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/LEARNING/c08ca2c91e504b8cf7b7891fdf7ea24a.png?v=77",
"name": "Corvus OTP Demo",
"merchant": "Demo",
"description": null,
"serviceKey": "c08ca2c91e504b8cf7b7891fdf7ea24a"
},
{
"image": "https://store-demo.centili.com/res/sf/SF_DEMO/LEARNING/fcdd76900fe3e428eb808e46c4c3de19.png?v=77",
"name": "WSPay OTP Demo",
"merchant": "Demo",
"description": null,
"serviceKey": "fcdd76900fe3e428eb808e46c4c3de19"
}
]
}
]
Response parameters
Parameter | Description | Example |
---|---|---|
categoryName | Name of service category | Gaming |
services | List of services for a specific category. See (https://dev.centili.com/docs/get-services-1#service) | { "image":"https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77", "name":"XBox ", "merchant":"Demo Storefront", "description":"Xbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices.", "serviceKey":"a015bd48b95345cba6ee4ba8e84d7256" } |
Service
Parameter | Description | Example |
---|---|---|
name | A service name associated with a given service | XBox |
serviceKey | Centili-issued service key, unique for every payment service. Consists of alphanumeric characters and counts up to 32 characters. | a015bd48b95345cba6ee4ba8e84d7256 |
description | A service description associated with a given service | Xbox Live is an online multiplayer gaming and digital media delivery service created and operated by Microsoft. The service is used by the Xbox system as well as mobile and PC devices. |
image | An image associated with a given service | https://store-demo.centili.com/res/sf/SF_DEMO/GAMING/a015bd48b95345cba6ee4ba8e84d7256.png?v=77 |
merchant | Merchant/client name associated with a given service | Demo Storefront |
4xx client error / 5xx server error
400 - Mandatory request parameters not present
401 - Invalid credentials
404 - Domain not configured
500 - Request can not be processed at the current time
HTTP/1.1 401 Unauthorized
Content-Type: application/json
{
"message": "Authorization failed",
"code": "AUTH_FAILED"
}
Parameter | Description | Example |
---|---|---|
code | Error response code | AUTH_FAILED |
message | Error response message | Authorization failed |
Updated over 1 year ago