diff --git a/src/pages/getting-started/index.md b/src/pages/getting-started/index.md index dd0befa..937d3e6 100644 --- a/src/pages/getting-started/index.md +++ b/src/pages/getting-started/index.md @@ -16,19 +16,47 @@ description: Getting started with the Adobe Stock API. Build an API application # 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 -``` +Please read me! - > \* **Adobe Developer Console**: [https://developer.adobe.com/console/](https://developer.adobe.com/console/)
- > \*\* **curl**: [https://curl.haxx.se/](https://curl.haxx.se/) +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). -## Read me first! +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](mailto: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](./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! -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