-
Notifications
You must be signed in to change notification settings - Fork 19
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #73 from AdobeDocs/Prerelease
Prerelease
- Loading branch information
Showing
1 changed file
with
37 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -16,19 +16,47 @@ description: Getting started with the Adobe Stock API. Build an API application | |
|
||
# Getting started with the Adobe Stock API | ||
|
||
<InlineAlert variant="success" slots="text"/> | ||
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! | ||
<InlineAlert variant="warning" slots="header, text1, text2, text3, text4" /> | ||
|
||
```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/)<br /> | ||
> \*\* **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:[email protected]) with questions. | ||
|
||
<!-- | ||
To request approval: Go to https://www.adobeprerelease.com and join the "Adobe Stock API" program. As noted, if you have been approved to join the Adobe Affiliate program, then you should be approved to use the Stock API. | ||
--> | ||
|
||
## 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. | ||
|
||
<InlineAlert slots="text" /> | ||
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 | ||
|
||
|