From 88645cc779be1e044a75e5550cbe9f21a5069364 Mon Sep 17 00:00:00 2001 From: Christopher Smith Date: Fri, 22 Nov 2024 15:28:02 -0800 Subject: [PATCH 1/2] Prerelease change --- src/pages/getting-started/index.md | 43 +++++++++++++++++++++++++++--- 1 file changed, 39 insertions(+), 4 deletions(-) diff --git a/src/pages/getting-started/index.md b/src/pages/getting-started/index.md index dd0befa..e49ad08 100644 --- a/src/pages/getting-started/index.md +++ b/src/pages/getting-started/index.md @@ -14,6 +14,45 @@ description: Getting started with the Adobe Stock API. Build an API application +# Please read me first! + +Beginning in November, 2024, the Stock API will only be available to Stock for Enterprise customers. If you don't know if you have Stock for Enterprise, see [Do I have Stock for Enterprise?](#do-i-have-stock-for-enterprise) To create an integration, you must either be a System Administrator or a [member of the Developers group](https://helpx.adobe.com/enterprise/using/manage-developers.html) for the Stock product. *Hint: If you do not see an option to add Developers or API credentials, then you **do not** have Stock for Enterprise.* If you want to get a quote for Stock for Enterprise, please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi). + +If you are a Stock for Enterprise customer, then you can create a [Server to Server integration](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/), which does not require a login. Go to [Getting Started](./getting-started/index.md) to begin. + +If you do not have Stock for Enterprise, then you will not be able to create an integration at this time without being accepted into a program unless you have a compelling business reason or have an Adobe business sponsor. Adobe affiliates who are approved to join the Adobe campaign may be pre-approved. + +The approval process is still being rolled out. You may email [the Stock API team](stockapis@adobe.com) with questions. + + +## Do I have Stock for Enterprise? + +1. First, do you have access to the [Adobe Admin Console](https://adminconsole.adobe.com/)? +2. Second, when you click on Products, do you see an Adobe Stock product or a Creative Cloud (CC) product? In the screenshot below, this customer has an Adobe Stock Credits product, as well as a CC All Apps product. They can use the Stock API, but only with their Stock credits product. They cannot create an integration for CC All Apps because it is not a Stock product. + +![Stock product](./getting-started/stock-api-available.png) + +For more information on why Creative Cloud does not have API access, see the FAQ [May I use my Creative Cloud Professional or Professional Plus plan with the Stock API?](https://developer.adobe.com/stock/docs/faq/stock-api-business-faq/#may-i-use-my-creative-cloud-professional-or-professional-plus-plan-with-the-stock-api). + +## Adobe Affiliates + +Join the Adobe Affiliate Program and earn attractive commissions. Promote Adobe Creative Cloud, Adobe Stock and Adobe Document Cloud on your website, blog or social media channel. It's free, it's easy, and it pays. + +While most Adobe Affiliates display banner advertising on their websites, affiliate partners can choose to integrate with the Stock Search API to create a custom search experience for their users. + + * To join the Adobe Affiliate Program, go here: [https://www.adobe.com/affiliates.html](https://www.adobe.com/affiliates.html). + * For an in-depth use case, see [Get Paid to Search Adobe Stock!](https://medium.com/adobetech/get-paid-to-search-adobe-stock-e2ba9a7c0312) + +See the [Affiliates FAQ](faq/stock-api-business-faq.md#affiliates-faq) for more information. + +Note that you will still need to join the [Stock API Prerelease program](https://www.adobeprerelease.com) as well as join the Adobe Affiliate program. + + + +Continue here once you have access to the API! + # Getting started with the Adobe Stock API @@ -26,10 +65,6 @@ curl -H 'x-api-key:myAPIKey' -H 'x-product:myTestApp1.0' https://stock.adobe.io/ > \* **Adobe Developer Console**: [https://developer.adobe.com/console/](https://developer.adobe.com/console/)
> \*\* **curl**: [https://curl.haxx.se/](https://curl.haxx.se/) -## Read me first! - -Before you begin, be sure to review the [Developer Terms of Use](/faq/terms-for-adobe-stock-developers.md). Or better yet, bookmark it. There will be a quiz later :) - ## Overview The Adobe Stock API provides programmatic access to [Adobe Stock](https://stock.adobe.com/) content. You can integrate this API into your organization's applications and processes. You can use the API in scripts or programs to search for and retrieve Adobe Stock assets such as photos, videos, and vector files, and to license assets for your users. From c43f024a2e02fb472609ce15b8da751b07bddbf6 Mon Sep 17 00:00:00 2001 From: Christopher Smith Date: Fri, 22 Nov 2024 15:37:27 -0800 Subject: [PATCH 2/2] Prerelase support --- src/pages/getting-started/index.md | 25 +++++++++---------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/src/pages/getting-started/index.md b/src/pages/getting-started/index.md index e49ad08..937d3e6 100644 --- a/src/pages/getting-started/index.md +++ b/src/pages/getting-started/index.md @@ -14,15 +14,20 @@ description: Getting started with the Adobe Stock API. Build an API application -# Please read me first! +# Getting started with the Adobe Stock API + + + +Please read me! Beginning in November, 2024, the Stock API will only be available to Stock for Enterprise customers. If you don't know if you have Stock for Enterprise, see [Do I have Stock for Enterprise?](#do-i-have-stock-for-enterprise) To create an integration, you must either be a System Administrator or a [member of the Developers group](https://helpx.adobe.com/enterprise/using/manage-developers.html) for the Stock product. *Hint: If you do not see an option to add Developers or API credentials, then you **do not** have Stock for Enterprise.* If you want to get a quote for Stock for Enterprise, please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi). -If you are a Stock for Enterprise customer, then you can create a [Server to Server integration](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/), which does not require a login. Go to [Getting Started](./getting-started/index.md) to begin. +If you are a Stock for Enterprise customer, then you can create a [Server to Server integration](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/), which does not require a login. Go to [Overview](#overview) to begin. If you do not have Stock for Enterprise, then you will not be able to create an integration at this time without being accepted into a program unless you have a compelling business reason or have an Adobe business sponsor. Adobe affiliates who are approved to join the Adobe campaign may be pre-approved. -The approval process is still being rolled out. You may email [the Stock API team](stockapis@adobe.com) with questions. +The approval process is still being rolled out. You may email [the Stock API team](mailto:stockapis@adobe.com) with questions. + @@ -32,7 +37,7 @@ To request approval: Go to https://www.adobeprerelease.com and join the "Adobe S 1. First, do you have access to the [Adobe Admin Console](https://adminconsole.adobe.com/)? 2. Second, when you click on Products, do you see an Adobe Stock product or a Creative Cloud (CC) product? In the screenshot below, this customer has an Adobe Stock Credits product, as well as a CC All Apps product. They can use the Stock API, but only with their Stock credits product. They cannot create an integration for CC All Apps because it is not a Stock product. -![Stock product](./getting-started/stock-api-available.png) +![Stock product](./stock-api-available.png) For more information on why Creative Cloud does not have API access, see the FAQ [May I use my Creative Cloud Professional or Professional Plus plan with the Stock API?](https://developer.adobe.com/stock/docs/faq/stock-api-business-faq/#may-i-use-my-creative-cloud-professional-or-professional-plus-plan-with-the-stock-api). @@ -50,20 +55,8 @@ See the [Affiliates FAQ](faq/stock-api-business-faq.md#affiliates-faq) for more Note that you will still need to join the [Stock API Prerelease program](https://www.adobeprerelease.com) as well as join the Adobe Affiliate program. - Continue here once you have access to the API! -# Getting started with the Adobe Stock API - - -TL;DR: (1) register for an Adobe Stock API key at the Adobe Developer Console*, (2) Add your API key in the following curl** command and make your first search query, then (3) return here to learn more! - -```shell -curl -H 'x-api-key:myAPIKey' -H 'x-product:myTestApp1.0' https://stock.adobe.io/Rest/Media/1/Search/Files?locale=en_US%26search_parameters%5Bwords%5D=kittens -``` - - > \* **Adobe Developer Console**: [https://developer.adobe.com/console/](https://developer.adobe.com/console/)
- > \*\* **curl**: [https://curl.haxx.se/](https://curl.haxx.se/) ## Overview