Recommended Services for Listing
get
/appstore/publisher/v1/applications/{listingVersionId}/availableservices
Get a list of service integrators. Publishers can recommend particular service integrators for their application listings by adding them to each application listing as recommended services.
Request
Path Parameters
-
listingVersionId: integer(int64)
Unique identifier of the listing for which available services are required.
Query Parameters
-
keyword(optional): string
This is a filter. If specified, recommended services specific to the keyword are returned.
-
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 : recommendedService
Type:
Show Source
object
-
code(optional):
string
-
largeAppIconId(optional):
integer(int64)
-
links(optional):
array link
-
name(optional):
string
-
partnerName(optional):
string
-
rating(optional):
number(double)
-
reviewCount(optional):
integer(int64)
-
serviceId(optional):
integer(int64)
-
smallAppIconId(optional):
integer(int64)
-
tagLine(optional):
string
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
The following example fetches the recommended services for their application listings, 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/applications/6186119/availableservices?keywords=crm&limit=1"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items": [ { "recommendedService": { "name": "6eTechnologies Cloud Solution", "serviceId": 4974621, "partnerName": "6e Technologies" } } ], "hasMore": true, "count": 1, "totalResults": 425, "links": [ { "rel": "CANONICAL", "href": "https://ocm-apis.ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/6186119/availableservices" }, { "rel": "SELF", "href": "https://ocm-apis.ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/6186119/availableservices?keywords=crm&limit=1" }, { "rel": "NEXT", "href": "https://ocm-apis.ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/6186119/availableservices?keywords=crm&offset=1&limit=1" } ] }Back to Top