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

Application Details

get

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

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

Request

Path Parameters
Back to Top

Response

Supported Media Types

200 Response

Successful Operation
Body ()
Root Schema : AppListing
Type: object
Show Source
Nested Schema : AdditionalInfo
Type: object
Show Source
Nested Schema : Banner
Type: object
Show Source
Nested Schema : Item
Type: object
Show Source
Nested Schema : DownloadInfo
Type: object
Show Source
Nested Schema : Icon
Type: object
Show Source
Nested Schema : languages
Type: array
Show Source
Nested Schema : markets
Type: array
Show Source
Nested Schema : ListingPreInstallNote
Type: object
Show Source
Nested Schema : PricingDetails
Type: object
Show Source
Nested Schema : products
Type: array
Show Source
Nested Schema : Progress
Type: object
Show Source
Nested Schema : recommededServiceIntegrators
Type: array
Show Source
Nested Schema : regions
Type: array
Show Source
Nested Schema : relatedDocuments
Type: array
Show Source
Nested Schema : screenShots
Type: array
Show Source
Nested Schema : SupportInfo
Type: object
Show Source
Nested Schema : supportingDocuments
Type: array
Show Source
Nested Schema : ListingVersion
Type: object
Show Source
Nested Schema : market
Type: object
Show Source
Nested Schema : billToCountries
Type: array
The list of countries of customer
Show Source
Nested Schema : UploadData
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 : Region
Type: object
Show Source
Nested Schema : countries
Type: array
Show Source
Nested Schema : RelatedDocs
Type: object
Show Source
Nested Schema : UploadFile
Type: object
Show Source
Nested Schema : InputStream
Type: object
Nested Schema : ScreenShots
Type: object
Show Source
Nested Schema : contacts
Type: array
Show Source
Nested Schema : SupportContact
Type: object
Show Source
Nested Schema : SupportingDocs
Type: object
Show Source

400 Response

Bad Request

401 Response

Not Authorized

500 Response

System Error
Back to Top

Examples

The following example returns details of an application listing 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/2801500"

Request Header

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

Request Body

None

HTTP Status Code:

200 OK

JSON Response:

{
    "name": "QA-18.2.6-v1",
    "listingId": 2829370,
    "listingVersionId": 2829371,
    "products": [
        {
            "code": "marketing",
            "name": "Marketing Cloud",
            "categories": [
                {
                    "code": "DATA_SOURCES_AND_QUALITY",
                    "name": "Data Sources and Quality"
                }
            ],
            "filters": [
                {
                    "code": "MARKETINGPRODUCT",
                    "name": "Marketing Product",
                    "usageInstructions": "Select the marketing product associated to the listing.",
                    "multiSelect": false,
                    "mandatory": true,
                    "values": [
                        {
                            "code": "ELOQUA",
                            "name": "Eloqua"
                        }
                    ]
                }
            ]
        }
    ],
    "deviceType": {
        "code": "BROWSER",
        "name": "Browser"
    },
    "pricing": {
        "type": "PAYGO",
        "name": "Paid",
        "pricingRate": 0.1,
        "description": "Pricing description",
        "pricingStrategy": "PER_OCPU_LINEAR",
        "ociListing": true
    },
    "markets": [{
        "code": "US",
        "name": "US Commercial",
        "category": "Commercial",
        "billToCountries" : [
            "United States"
        ]
    }],
    "isPrivate":true,
    "privateURL":"https://slc15gpk.us.oracle.com/marketplace/listing/2829370",
    "shortDescription": "Akeneo is a Product Information Management short description.",
    "longDescription": "Akeneo is a Product Information Management (PIM) application designed to simplify your product management processes. The main purpose of a PIM is to be a central repository of all product data of a company.",
    "usageInformation": "Usage information for the product Akeneo",
    "tags": "Acme, Product Information Management",
    "tagLine": "Powerful PIM designed to simplify management processes",
    "listingContentLanguage": {
        "code": "en_US",
        "name": "English"
    },
    "versionDetails": {
        "versionNumber": "1.4.18-0 on OL 6.7",
        "description": "Change Log",
        "releaseDate": "2016-02-04T07:00:00.000Z"
    },
    "systemRequirements": "Oracle Cloud 
 Minimum profile: General OC3 | 1 OCPU, 7.5 Gb RAM, 60 GB Local Disk ",
    "hasTemplate": false,
    "languages": [
        {
            "code": "es_ES",
            "name": "Spanish"
        },
        {
            "code": "zh_TW",
            "name": "Chinese (Traditional)"
        },
        {
            "code": "en_US",
            "name": "English"
        }
    ],
    "status": "NEW",
    "recommededServiceIntegrators": [
        {
            "name": "Max org 03 Service",
            "serviceId": 1777250
        },
        {
            "name": "msp-a1_v2",
            "serviceId": 2673429
        },
        {
            "name": "msiA",
            "serviceId": 2794110
        }
    ],
    "demoURL": "https://www.oracle.com/downloads/index.html",
    "downloadInfo": {
        "type": "URL",
        "value": "http://www.oracle.com"
    },
    "additionalInfo": {
        "vanityURLSuffix": "/app/123456",
        "vanityURL": "https://cloudmarketplace.oracle.com/marketplace/app/123456"
    },
    "support": {
        "contacts": [
            {
                "name": "Tech Support",
                "phone": "123456",
                "email": "email@email.com",
                "subject": "Need help"
            },
            {
                "name": "Acme Support",
                "phone": "123456",
                "email": "oracle-marketplace-support@example.com",
                "subject": "Acme for Oracle Compute Cloud"
            }
        ],
        "links": [
            {
                "name": "Acme Community",
                "url": "https://community.example.com/"
            },
            {
                "name": "Title",
                "url": "http://www.jsondiff.com"
            },
            {
                "name": "Acme Support Page",
                "url": "https://example.com/support"
            }
        ]
    },
    "icon": {
        "name": "star.png",
        "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829443",
        "resourceURL": "https://ocm-apis-cloud.oracle.com/appstore/publisher/v1/applications/2829371/icon/2829443",
        "mimeType": "image/png",
        "fileExtension": "png"
    },
    "banner": {
        "name": "BannerName",
        "fileName": "banner.png",
        "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829441",
        "resourceURL": "https://ocm-apis-cloud.oracle.com/appstore/publisher/v1/applications/2829371/banner/2829441",
        "mimeType": "image/png",
        "fileExtension": "png"
    },
    "relatedDocuments": [
        {
            "name": "RelatedDoc2",
            "contentType": "CUSTOMIZATION_GUIDES",
            "sourceType": "INTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829502",
            "fileName": "boxarrow_qual_72.svg",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/relateddocs/2829502",
            "forOracleUsersOnly": false
        },
        {
            "name": "RelDocName",
            "contentType": "WEBINARS",
            "sourceType": "EXTERNAL",
            "sourceURL": "http://www.jsondiff.com/",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/relateddocs/2829504",
            "forOracleUsersOnly": false
        },
        {
            "name": "RelatedDocName",
            "contentType": "CASE_STUDIES",
            "sourceType": "INTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829500",
            "fileName": "boxarrow_qual_72.svg",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/relateddocs/2829500",
            "forOracleUsersOnly": true
        }
    ],
    "screenShots": [
        {
            "name": "ScreenshotName",
            "description": "ScreenshotDescription",
            "sourceType": "Internal",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829521",
            "fileName": "disabledButtonScreenshot.JPG",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/screenshots/2829521",
            "mimeType": "image/jpeg",
            "fileExtension": "JPG",
            "sequence": 1
        },
        {
            "name": "Video Name",
            "description": "Video Description",
            "sourceType": "EXTERNAL",
            "sourceURL": "https://www.youtube.com/watch?v=SgujaIzkwrE",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/screenshots/2829523",
            "sequence": 2
        }
    ],
    "availableInAllRegions": false,
    "regions": [
        {
            "code": "APAC",
            "name": "Asia Pacific",
            "countries": [
                {
                    "code": "India",
                    "name": "India"
                }
            ]
        },
        {
            "code": "NA",
            "name": "North America",
            "countries": [
                {
                    "code": "Canada",
                    "name": "Canada"
                }
            ]
        }
    ],
    "packageAvailable": true,
    "versionedListing": false,
    "progress": {
        "percentage": "80",
        "message": "In Progress"
    },
    "preInstallNoteDetails": {
        "preInstallNoteId": 2333727,
        "additionalInfo": "
Additional Information Details

",
        "name": "1726TestPII",
        "entityType": {
            "code": "INTERNAL_APPS"
        },
        "content": {
            "contentURL": "https://cloudmarketplace.oracle.com/marketplace/content?contentId=2333728&render=inline",
            "mimeType": "text/html",
            "fileExtension": "html"
        }
    },
    "allowedTenancies": [
        {
            "allowedTenancy": "ocid1.tenancy.oc1..unique_id"
        },
        {
            "allowedTenancy": "ocid1.tenancy.oc1..unique_id"
        }
    ],
    "supportingDocuments": [
        {
            "name": "supporting doc name",
            "description": "Description details",
            "contentType": "SUPPORTING_DOC_1716",
            "sourceType": "INTERNAL",
            "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2829559",
            "fileName": "activityStream.JPG",
            "resourceURL": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371/supportingdocs/2829559",
            "lastUpdatedTime": "2018-07-04T07:24:14.017Z"
        }
    ],
    "lastUpdateDate": "2018-07-04T11:33:18.869Z",
    "links": [
        {
            "rel": "CANONICAL",
            "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/applications/2829371"
        }
    ]
}
Back to Top