List of Products
get
/appstore/publisher/v1/products
Get a list of products that can be associated with applications and services.
Request
Query Parameters
-
expands(optional): string
It is a optional parameter and accepts categories, filters or both (comma-separated) as value. If it is mentioned, the api returns products and all categories and/or filters of that product.
-
limit(optional): integer(int32)
Limit tells how many records to return (starting from the offset). Limit should be greater than zero and less than or equal to 100 (default=30).
-
offset(optional): integer(int32)
Offset and limit together determine how many records to return from the collection. Offset is the starting index of the records to return, which should be greater than or equal to zero (default=0).
Response
Supported Media Types
- application/json;qs=1
- application/xml;qs=.5
200 Response
Successful Operation
Nested Schema : Link
Type:
Show Source
object
-
href(optional):
string
-
rel(optional):
string
Allowed Values:
[ "SELF", "CANONICAL", "NEXT", "TEMPLATE", "PREV" ]
400 Response
Invalid Parameter Value
401 Response
Not Authorized
404 Response
Entity Not Found
500 Response
System Error
Examples
1.List of Products without expands queryparam
The following example returns a list of all the products associated with a partner, by submitting a GET request on the REST resource using cURL.
cURL Example
curl -X GET -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products?limit=2&offset=2"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items": [ { "product": { "code": "compute", "name": "Compute Cloud" } } ], "hasMore": false, "count": 1, "totalResults": 3, "links": [ { "rel": "CANONICAL", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products" }, { "rel": "SELF", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products?offset=2&limit=2" }, { "rel": "PREV", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products?limit=2" } ] }
2.List of Products with expands queryparam
The following example returns a list of all the products and its categories , by submitting a GET request on the REST resource using cURL.
cURL Example
curl -X GET -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products?expands=categories"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items":[ { "product":{ "code":"compute", "name":"Compute Cloud", "categories":[ { "code":"CLOUD_MIGRATION", "name":"Cloud Migration" }, { "code":"APPLICATIONS_UNLIMITED", "name":"Applications Unlimited" }, { "code":"CLOUD_MANAGEMENT", "name":"Cloud Management" }, { "code":"VIRTUAL_MACHINES", "name":"Virtual Machines" }, { "code":"SAAS_ON_ORACLE_CLOUD_PLATFORM", "name":"SaaS on Oracle Cloud Platform" }, { "code":"READY", "name":"Ready" } ] } } ], "hasMore":false, "count":1, "totalResults":1, "links":[ { "rel":"CANONICAL", "href":"https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products" }, { "rel":"SELF", "href":"https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/products?expands=categories" } ] }Back to Top