Jump to

• Request
• Response
• Examples

Details of Specific Version

get

/appstore/publisher/v{vNumber}

Get the details of a particular version with the given version number.

Request

Path Parameters

• vNumber: integer(int64)
  Version number whose details are required

Back to Top

Response

Supported Media Types

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

200 Response

Successful Operation

Body ()

Root Schema : version

Type: object

Show Source

• buildVersion(optional): string
• latest(optional): boolean
  Default Value: false
• lifecycle(optional): string
• links(optional): array link
• predecessor(optional): string
• resourceList(optional): array resourceList
• successor(optional): string
• terminationDate(optional): string
• version(optional): string

{
    "type":"object",
    "properties":{
        "version":{
            "type":"string"
        },
        "latest":{
            "type":"boolean",
            "default":false
        },
        "lifecycle":{
            "type":"string"
        },
        "buildVersion":{
            "type":"string"
        },
        "terminationDate":{
            "type":"string"
        },
        "predecessor":{
            "type":"string"
        },
        "successor":{
            "type":"string"
        },
        "resourceList":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/CatalogEntry"
            }
        },
        "links":{
            "type":"array",
            "xml":{
                "name":"link",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "xml":{
        "name":"version"
    }
}

Nested Schema : link

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "xml":{
        "name":"link",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : resourceList

Type: array

Show Source

• Array of: object catalogEntry

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/CatalogEntry"
    }
}

Nested Schema : Link

Type: object

Show Source

• href(optional): string
• rel(optional): string
  Allowed Values: [ "SELF", "CANONICAL", "NEXT", "TEMPLATE", "PREV" ]

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "xml":{
                "attribute":true
            },
            "enum":[
                "SELF",
                "CANONICAL",
                "NEXT",
                "TEMPLATE",
                "PREV"
            ]
        },
        "href":{
            "type":"string",
            "xml":{
                "attribute":true
            }
        }
    }
}

Nested Schema : catalogEntry

Type: object

Show Source

• allowedMethods(optional): array allowedMethods
• links(optional): array link
• root(optional): string

{
    "type":"object",
    "properties":{
        "root":{
            "type":"string"
        },
        "allowedMethods":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "links":{
            "type":"array",
            "xml":{
                "name":"link",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "xml":{
        "name":"catalogEntry"
    }
}

Nested Schema : allowedMethods

Type: array

Show Source

• Array of: string

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

Nested Schema : link

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "xml":{
        "name":"link",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/Link"
    }
}

400 Response

Invalid Parameter Value

401 Response

Not Authorized

404 Response

Entity Not Found

500 Response

System Error

Back to Top

Examples

The following example return details of a particular version, by submitting a GET request on the REST resource using cURL.

cURL Example

curl -X GET -H "Authorization: Bearer Access-token" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v4"

Request Header

Authorization: Bearer Access-token

Request Body

None

HTTP Status Code:

200 OK

JSON Response:

{
  "version": "v4",
  "latest": true,
  "lifecycle": "expired",
  "terminationDate": "2016-03-15T16:16:39.000Z",
  "predecessor": "v3",
  "resourceList": {
  {
   "root": "applications",
   "allowedMethods": [
      "POST", "GET"
   ],
   "links": [
      {
        "rel": "TEMPLATE",
        "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v4/applications"
      }
   ]
  },
  {
   "root": "applications",
   "allowedMethods": [
      "GET", "PUT", "DELETE", "PATCH"
   ],
   "links": [
      {
        "rel": "TEMPLATE",
        "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v4/applications/{id}"
      }
   ]
  }
    --------- all Other supported resources in this version -----------
 },

  "links": [
    {
      "rel": "CANONICAL",
      "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v4"
    }
  ]
}

Back to Top