Get terms
get
/appstore/publisher/v1/terms
Fetch all the terms and its version details.
Request
Query Parameters
-
termsstatus(optional): string
This query parameter is used to fetch all the active terms version. It will return all the terms and only active versions of that term. Only acceptable value is ACTIVE.
-
termsversionid(optional): integer(int32)
This query parameter is used to fetch details of only specified terms version.
Response
Supported Media Types
- application/json;qs=1
- application/xml;qs=.5
200 Response
Successful Operation
401 Response
Not Authorized
404 Response
Entity Not Found
500 Response
System Error
Examples
1. Get all terms
The following example returns details of terms and its versions, 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" -H "Content-Type: application/json" -d 'JSON-data-as-shown-in-following-example' "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?limit=2"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items": [ { "terms": { "termsId": 2331248, "termVersions": [ { "termsVersionId": 2331250, "versionName": "Stage-REST", "rawVersionName": "", "status": "Active", "contentId": 2331251, "lastUpdateDate": "2017-06-19T06:31:52.000Z", "lastUpdatedBy": "Appstore Admin", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2331251" } ] } }, { "terms": { "termsId": 2019655, "termVersions": [ { "termsVersionId": 2019656, "versionName": "Partner Level Terms of Use", "rawVersionName": "", "status": "Active", "contentId": 2019657, "lastUpdateDate": "2016-11-17T07:16:12.000Z", "lastUpdatedBy": "John Doe", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2019657" }, { "termsVersionId": 2333798, "versionName": "Terms of Use 4", "rawVersionName": "", "status": "New", "contentId": 2333799, "lastUpdateDate": "2017-06-20T07:26:05.616Z", "lastUpdatedBy": "Appstore Admin", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2333799" } ] } } ], "hasMore": true, "count": 2, "totalResults": 4, "links": [ { "rel": "CANONICAL", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms" }, { "rel": "SELF", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?limit=2" }, { "rel": "NEXT", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?offset=2&limit=2" } ] }
2. Get active terms
The following example returns details of terms and its active version, by submitting a GET request on the REST resource using cURL.
cURL Example
curl -X PATCH -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" -H "Content-Type: application/json" -d 'JSON-data-as-shown-in-following-example' "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?termsstatus=ACTIVE"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items": [ { "terms": { "termsId": 2710876, "termVersions": [ { "termsVersionId": 2710877, "versionName": "AppsUnlimited Special Programs Terms", "rawVersionName": "AppsUnlimited Special Programs Terms", "status": "Active", "contentId": 2710878, "lastUpdateDate": "2018-04-13T20:41:09.000Z", "lastUpdatedBy": "John Doe", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2710878" } ] } }, { "terms": { "termsId": 1534901, "termVersions": [ { "termsVersionId": 1535035, "versionName": "Copy of Lang TnC InternalApps_One", "rawVersionName": "Copy of Lang TnC InternalApps_One", "status": "Active", "contentId": 1535036, "lastUpdateDate": "2016-03-11T12:27:18.000Z", "lastUpdatedBy": "Appstore Admin", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=1535036" } ] } } ], "hasMore": true, "count": 2, "totalResults": 17, "links": [ { "rel": "CANONICAL", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms" }, { "rel": "SELF", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?termsstatus=ACTIVE&limit=2" }, { "rel": "NEXT", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?termsstatus=ACTIVE&offset=2&limit=2" } ] }
3. Get specific terms version
The following example returns details of terms version, by submitting a GET request on the REST resource using cURL.
cURL Example
curl -X PATCH -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" -H "Content-Type: application/json" -d "JSON-data-as-shown-in-following-example" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?termsversionid=2710877&expands=desc"
Request Header
X-Oracle-UserId: fname.lname@oracle.com Authorization: Bearer Access-token
Request Body
None
HTTP Status Code:
200 OK
JSON Response:
{ "items": [ { "terms": { "termsId": 2710876, "termVersions": [ { "termsVersionId": 2710877, "versionName": "AppsUnlimited Special Programs Terms", "rawVersionName": "", "contentDescription": "In keeping with Oracle's trade compliance obligations under U.S. and applicable multilateral law, failure to comply with this policy could result in disciplinary action up to and including termination.Back to TopLast updated 21 November 2014
", "status": "Active", "contentId": 2710878, "lastUpdateDate": "2018-04-13T20:41:09.000Z", "lastUpdatedBy": "John Doe", "contentURL": "https://partner.cloudmarketplace.oracle.com/partner/content?contentId=2710878" } ] } } ], "hasMore": false, "count": 1, "totalResults": 1, "links": [ { "rel": "CANONICAL", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms" }, { "rel": "SELF", "href": "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/terms?termsversionid=2710877&expands=desc" } ] }