Jump to

• Request
• Response
• Examples

Create Recommended Services

put

/appstore/publisher/v1/applications/{listingVersionId}/recommendedservices

Creates a list of recommended service integrators for an application with specified id. If the call is made with an empty list, it clears the entire existing list of recommended services associated with this application, if any.

Request

Path Parameters

• listingVersionId: integer(int64)
  Unique identifier of the application for which recommended services are to be added.

Body ()

List of recommended services to be integrated with the application.

Root Schema : schema

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top

Response

Supported Media Types

• application/json;qs=1
• application/xml;qs=.5

200 Response

Successful Operation

Body ()

Root Schema : acknowledgement

Type: object

Show Source

• contentURL(optional): string
• entityId(optional): string
• message(optional): string
• name(optional): string
• uri(optional): string

{
    "type":"object",
    "properties":{
        "message":{
            "type":"string"
        },
        "entityId":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "uri":{
            "type":"string"
        },
        "contentURL":{
            "type":"string"
        }
    },
    "xml":{
        "name":"acknowledgement"
    }
}

400 Response

Bad Request/Invalid Parameter/Invalid Parameter Value

401 Response

Not Authorized

500 Response

System Error

Back to Top

Examples

The following example adds the recommended services for an application, by submitting a PUT request on the REST resource using cURL.

cURL Example

curl -X PUT -H "X-Oracle-UserId: partner-email" -H "Content-Type: application/json" -H "Authorization: Bearer Access-token" -d 'JSON-data-as-shown-in-below-example' "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2601750/recommendedservices"

Request Header

Authorization: Bearer Access-token 
X-Oracle-UserId: [e-mail] 

Request Body

[ "1509852", "816708" ]

HTTP Status Code:

200 OK

JSON Response:

{
    "message": "Recommended services for application with id 2908689 were created.",
    "entityId": "2908689"
 }

Back to Top