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

Create Application

post

/appstore/publisher/v1/applications

Create a new application listing. The application goes through a state lifecycle. A newly created application starts off in the "New" state. Application edits are allowed in this state. To publish the listing to the Marketplace, the application listing needs to be submitted for approval.

Request

Supported Media Types
Body ()
Provide the body with required information.
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
Back to Top

Response

Supported Media Types

200 Response

Successful Operation
Body ()
Root Schema : acknowledgement
Type: object
Show Source

400 Response

Invalid Parameter Value/Bad Request

401 Response

Not Authorized

500 Response

System Error
Back to Top

Examples

The following example creates a new application for a partner and return the newly created listing ID by submitting a POST request on the REST resource using cURL.

cURL Example

curl -X POST -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"

Request Header

X-Oracle-UserId: fname.lname@oracle.com
Authorization: Bearer Access-token
Content-Type: application/json

Request Body

{
    "name": "REST API Test App01",
    "shortDescription": "White",
    "longDescription": "Example",
    "usageInformation": "Usage information for the App01",
    "tags": "Fusion CRM",
    "tagLine": "Sales Training Software | Sales Enablement",
    "versionDetails": {
        "versionNumber": "1.0v",
        "description": "Initial Release",
        "releaseDate": "2013-06-30T07:00:00.000Z"
    },
 "languages": [
        {
            "code": "en_US"
        },
        {
            "code": "fr_FR"
        }
    ],
    "products": [
        {
            "code": "SALES",
            "categories": [
                {
                    "code": "LEAD"
                },
                {
                    "code": "OPPORTUNITY"
                }
            ],
            "filters": [
                {
                    "code": "FILTERNAME",
                    "values": [
                        {
                            "code": "FILTERVALUECODE1"
                        },
                        {
                            "code": "FILTERVALUECODE2"
                        }
                    ]
                }
            ]
        },
        {
            "code": "MARKETING",
            "categories": [
                {
                    "code": "CHANNEL"
                }
            ],
            "filters": [
                {
                    "code": "FILTERNAME",
                    "values": [
                        {
                            "code": "FILTERVALUECODE1"
                        },
                        {
                            "code": "FILTERVALUECODE2"
                        }
                    ]
                }
            ]
        }
    ],
    "deviceType": {
        "code": "BROWSER"
    },
    "demoURL": "https://www.youtube.com/watch?v=Re4UA6_sD1E",
    "additionalInfo": {
        "vanityURL": "https://cloudmarketplace-stage.oracle.com/marketplace/app/vanityurlsample1testjan112",
        "vanityURLSuffix": "vanityurlsample1testjan112"
    },
    "pricing": {
        "type": "PAID",
        "description": "Subscription charges"
    },
    "markets": [{
        "code": "US",
        "name": "US Commercial",
        "category": "Commercial",
        "billToCountries" : [
            "United States"
        ]
    }],
    "downloadInfo": {
      "type": "TEXT",
      "value": "getapp"
     },
    "systemRequirements": "Test Notes Version 7, 8 and 9 are supported",
    "support": {
        "contacts": [
            {
                "name": "Technical Support",
                "phone": "1-908-679-0000",
                "email": "fname.lname@oracle.com",
                "subject": "Test subject"
            }
        ],
        "links": [
            {
                "name": "Test Listing Link",
                "url": "https://www.oracle.com"
            }
        ]
    },
   "availableInAllRegions" : false
}

HTTP Status Code:

201 Created

JSON Response:

{
  "message": "Listing was created successfully.",
  "entityId": "8422402",
  "name": "REST API Test App01"
}
Back to Top