1. REST API for Oracle Cloud Marketplace Publisher
  2. Tasks
  3. Service Resources

Service Details

get

/appstore/publisher/v1/services/{listingVersionId}

Get the details of the service with the specified listing ID.

Request

Path Parameters
Back to Top

Response

Supported Media Types

200 Response

Successful Operation
Body ()
Root Schema : Listing
Type: object
Show Source
Nested Schema : AdditionalInfo
Type: object
Show Source
Nested Schema : Banner
Type: object
Show Source
Nested Schema : customerStories
Type: array
Show Source
Nested Schema : Icon
Type: object
Show Source
Nested Schema : industries
Type: array
Show Source
Nested Schema : languages
Type: array
Show Source
Nested Schema : Item
Type: object
Show Source
Nested Schema : locations
Type: array
Show Source
Nested Schema : numberOfTrainedProfessionals
Type: object
Additional Properties Allowed
Show Source
Nested Schema : products
Type: array
Show Source
Nested Schema : Progress
Type: object
Show Source
Nested Schema : relatedDocuments
Type: array
Show Source
Nested Schema : screenShots
Type: array
Show Source
Nested Schema : serviceProviders
Type: array
Show Source
Nested Schema : SuccessStory
Type: object
Show Source
Nested Schema : UploadFile
Type: object
Show Source
Nested Schema : InputStream
Type: object
Nested Schema : Location
Type: object
Show Source
Nested Schema : product
Type: object
Show Source
Nested Schema : categories
Type: array
Show Source
Nested Schema : filters
Type: array
Show Source
Nested Schema : ProductFilter
Type: object
Show Source
Nested Schema : values
Type: array
Show Source
Nested Schema : RelatedDocs
Type: object
Show Source
Nested Schema : ScreenShots
Type: object
Show Source
Nested Schema : ServiceProvider
Type: object
Show Source

400 Response

Bad Request

401 Response

Not Authorized

500 Response

System Error
Back to Top

Examples

The following example fetches the service details, by submitting a GET request on the REST resource using cURL.

cURL Example

curl -X GET -H "Authorization: Bearer Access-token"  -H "X-Oracle-UserId: partner-email" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/127898339"

Request Header

Authorization: Bearer Access-token 
X-Oracle-UserId: fname.lname@oracle.com

Request Body

NONE

HTTP Status Code:

200 OK

JSON Response:

{
    "name": "APS18.2.4REST-SI",
    "listingId": 2829825,
    "listingVersionId": 2829826,
    "products": [
        {
            "code": "compute",
            "name": "Compute Classic"
        },
        {
            "code": "marketing",
            "name": "Marketing Cloud"
        }
    ],
    "shortDescription": "short description keywords",
    "longDescription": "Long description mandatory",
    "tags": "keywords keywords",
    "tagLine": "tag line",
    "listingContentLanguage": {
        "code": "iw_IL",
        "name": "Hebrew"
    },
    "hasTemplate": false,
    "languages": [
        {
            "code": "en_US",
            "name": "English"
        }
    ],
    "status": "NEW",
    "additionalInfo": {
        "vanityURLSuffix": "/service/123456",
        "vanityURL": "https://cloudmarketplace.oracle.com/marketplace/service/123456"
    },
    "icon": {
        "name": "star.png",
        "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829840",
        "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/icon/2829840",
        "mimeType": "image/png",
        "fileExtension": "png"
    },
    "banner": {
        "name": "Banner Name",
        "fileName": "banner.png",
        "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829838",
        "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/banner/2829838",
        "mimeType": "image/png",
        "fileExtension": "png"
    },
    "relatedDocuments": [
        {
            "name": "Rel Doc 1",
            "contentType": "PRESS_RELEASE",
            "sourceType": "INTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829858",
            "fileName": "Capture.PNG",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/relateddocs/2829858",
            "forOracleUsersOnly": false
        },
        {
            "name": "Rel Doc 2",
            "contentType": "WEBINARS",
            "sourceType": "EXTERNAL",
            "sourceURL": "https://www.youtube.com/watch?v=5Cn48KVK7FU",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/relateddocs/2829860",
            "forOracleUsersOnly": true
        }
    ],
    "screenShots": [
        {
            "name": "Screenshot Name",
            "description": "Screenshot Description",
            "sourceType": "Internal",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829854",
            "fileName": "PartnerSpecificService.PNG",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/screenshots/2829854",
            "mimeType": "application/octet-stream",
            "fileExtension": "PNG",
            "sequence": 1
        },
        {
            "name": "Video Name",
            "description": "Video Description",
            "sourceType": "EXTERNAL",
            "sourceURL": "https://www.youtube.com/watch?v=5Cn48KVK7FU",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/screenshots/2829856",
            "sequence": 2
        }
    ],
    "industries": [
        {
            "code": "PUBLIC_SECTOR",
            "name": "Public Sector"
        },
        {
            "code": "HEALTHCARE",
            "name": "Healthcare"
        },
        {
            "code": "CONSUMER_GOODS",
            "name": "Consumer Goods"
        }
    ],
    "customerStories": [
        {
            "name": "Customer Name",
            "sourceType": "INTERNAL,EXTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829852",
            "sourceURL": "http://ohcrest.doceng.oraclecorp.com",
            "fileName": "boxarrow_qual_72.svg",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/successstories/2829852"
        }
    ],
    "serviceProviders": [
        {
            "name": "Service Name 1",
            "description": "Service Description",
            "contentType": "CONSULTING_SERVICE",
            "sourceType": "INTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829862",
            "fileName": "Picture1.png",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/serviceproviders/2829862"
        },
        {
            "name": "Service Name 2",
            "description": "Service Description 2",
            "contentType": "APP_DEVELOPMENT_SERVICE",
            "sourceType": "EXTERNAL",
            "sourceURL": "https://www.youtube.com/watch?v=5Cn48KVK7FU",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826/serviceproviders/2829864"
        }
    ],
    "numberOfTrainedProfessionals": {
        "compute": "20"
    },
    "locations": [
        {
            "id": 2829867,
            "locationName": "Location Name",
            "addressLocation": "Address Location",
            "city": "City",
            "state": "State Name",
            "country": {
                "code": "United States",
                "name": "United States"
            },
            "zipCode": "123456",
            "contactPhone": "123456",
            "contactEmail": "email.support@oracle.com",
            "fax": "123456",
            "websiteUrl": "https://www.youtube.com/watch?v=5Cn48KVK7FU",
            "regions": [
                {
                    "code": "NA",
                    "name": "North America"
                }
            ]
        }
    ],
    "contactUs": "
Contact Us Info
",
    "opnLevel": "Silver",
    "opnTypeMemebershipServiceDetailsLink": "http://www.oracle.com/partners/en/partner-with-oracle/get-started/index.html#cw01step-2",
    "versionedListing": false,
    "progress": {
        "percentage": "100",
        "message": "Complete"
    },
    "lastUpdateDate": "2018-07-04T10:08:57.133Z",
    "links": [
        {
            "rel": "CANONICAL",
            "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/services/2829826"
        }
    ]
}
Back to Top