API Key
Fotolia 데이터베이스를 연결하기 위해서는 먼저 Fotolia API 키가 필요합니다. API 키는 회원 로그인 후 “도구상자” 에서 API 신청서를 작성함으로써 간단히 받을 수 있습니다. Fotolia API 키 종류는 다음의 3가지 입니다 : 파트너 API, 개발 API, 비지니스 API 각각의 API 기능은 아래 표를 참조하시기 바랍니다. 1개 이상의 API 키를 동시에 이용할 수 있습니다.
API 이용 약관
API 이용 약관은 API 이용 제반에 관한 내용을 규정하고 있습니다. API를 이용하기 전 API 이용 약관을 확인하시기 바랍니다.
인코딩
Fotolia API 내 모든 데이터는 UTF-8 형식으로 인코딩 되어 있어야 합니다.
UTF-8 인코딩 자세히 알아보기
Deprecated XML-RPC API
If you already implemented our API using the deprecated XML-RPC server, you can still access its documentation. We strongly encourage you to update it to use the new REST API as it won't be updated anymore
인증
몇몇 API 메소드는 인증 과정이 필요합니다 (아래 표 참조). 인증 과정은 비지니스 API 및 개발 API 에서만 필요하며, Fotolia 로그인을 통한 본인 확인 절차와 동일합니다. 로그인 ID 와 비밀번호는 API를 통해 보안화된 방식으로 전송되며, 로그인이 성공적으로 이루어지면 세션 ID가 할당됩니다. 이 세션 ID 는 각각의 API 메소드 이용 시 필요합니다. 인증 과정에 대한 보다 자세한 내용은 여기를 참조하시기 바랍니다.
API 호출 지원량
Fotolia를 통해 지원되는 API 호출은 500/시간, 혹은 10,000/일으로 제한되어 있습니다. 기본 지원량 이상의 호출량이 예상되는 경우에는 서비스 지원으로 문의하시기 바랍니다.
API 메소드
API 메소드는 API를 통해 다양한 기능을 설정할 수 있도록 해줍니다. 각각의 API 에 따른 기능 확인을 위해서는 다음의 표를 참조하세요.
| API 메소드 | 파트너 API | 비지니스 API | 개발 API | 리셀러 API | 인증 | 내용(기능) | ||
|---|---|---|---|---|---|---|---|---|
| 검색 | ||||||||
| getSearchResults |  |
|
|
|
no | 최대 검색 기능 | ||
| getCategories1 | |
|
|
|
no | 주제카테고리 | ||
| getCategories2 | |
|
|
|
no | 컨셉카테고리 | ||
| getTags | |
|
|
|
no | 태그 클라우드 | ||
| getGalleries | |
|
|
|
no | 공개갤러리 | ||
| getSeasonalGalleries | |
|
|
|
no | 공개갤러리 | ||
| getCountries | |
|
|
|
no | 국가 리스트t | ||
| 미디어 | ||||||||
| getMediaData | |
|
|
|
no | 미디어에 관한 모든 정보 | ||
| getBulkMediaData | |
|
|
|
no | 하나 이상의 미디어에 대한 모든 정보를 반환 | ||
| getMediaGalleries | |
|
|
|
no | 미디어 관련 갤러리 | ||
| getMedia | |
|
|
|
yes | 다운로드 링크(미디어구입) | ||
| getMediaComp | |
|
|
|
no | 샘플 이미지 URL | ||
| 사용자 | ||||||||
| loginUser | |
|
|
|
no | 사용자 로그인(인증 필요) | ||
| refreshToken | |
|
|
|
no | Renew authentication token | ||
| userSignUp | |
|
|
|
no | Create a new Fotolia user | ||
| userEditProfile | |
|
|
|
yes | Update the profile of a Fotolia's member | ||
| getUserData | |
|
|
|
yes | 로그인중인 사용자 정보 | ||
| getSalesData | |
|
|
|
yes | 사용자 매출 데이터 추출 | ||
| getUserStats | |
|
|
|
yes | 로그인중인 사용자 계정 통계 | ||
| getUserGalleries | |
|
|
|
yes | 로그인중인 사용자 갤러리 | ||
| getUserGalleryMedias | |
|
|
|
yes | 로그인중인 사용자 라이트박스/갤러리 | ||
| deleteUserGallery | |
|
|
|
yes | 로그인중인 사용자 갤러리 삭제 | ||
| createUserGallery | |
|
|
|
yes | 로그인중인 사용자 새 갤러리 생성 | ||
| addToUserGallery | |
|
|
|
yes | 로그인중인 사용자 갤러리 콘텐츠 추가 | ||
| removeFromUserGallery | |
|
|
|
yes | 로그인중인 사용자 갤러리 콘텐츠 삭제 | ||
| user.moveUpMediaInUserGallery | |
|
|
|
yes | move up a media in an user galleryr | ||
| user.moveDownMediaInUserGallery | |
|
|
|
yes | move down a media in an user gallery | ||
| user.moveMediaToTopInUserGallery | |
|
|
|
yes | move a media to top position in an user gallery | ||
| getUserAdvancedStats | |
|
|
|
yes | 로그인중인 사용자 계정 상세 통계 | ||
| getLastOnlineContents | |
|
|
|
Oui | Return last online files of the current user | ||
| getUploadFolders | |
|
|
|
Oui | Return the upload folders list of the authenticated contributor | ||
| getUploadFolderFileIds | |
|
|
|
yes | return file IDs inside an upload folder | ||
| uploadIdCard | |
|
|
|
Yes | Upload a new contributor ID card | ||
| upload | |
|
|
|
Yes | Upload a new file into user's account | ||
| getLastUploadedMedia | |
|
|
|
Yes | List the uploads made the last 7 days | ||
| 쇼핑카트 | ||||||||
| shoppingcart.getList | |
|
|
|
yes | 쇼핑카트 | ||
| shoppingcart.add | |
|
|
|
yes | 사용자 쇼핑카트에 미디어 추가 | ||
| shoppingcart.update | |
|
|
|
yes | 사용자 쇼핑카트 내 미디어 업데이트 | ||
| shoppingcart.remove | |
|
|
|
yes | 사용자 쇼핑카트 미디어 삭제 | ||
| shoppingcart.transferToLightbox | |
|
|
|
yes | 사용자 쇼핑카트 미디어 삭제 - 라이트박스에 추가 | ||
| shoppingcart.clear | |
|
|
|
yes | 사용자 쇼핑카트 비우기 | ||
| 기타 | ||||||||
| getData | |
|
|
|
no | Fotolia 일반 정보 | ||
| test | |
|
|
|
no | "Success" | ||
| 리셀러 API | ||||||||
| user.subaccount.getIds | |
|
|
|
no | 이용가능한 모든 서브계정 ID 배열 | ||
| user.subaccount.create | |
|
|
|
no | 리셀러 서브계정 생성 | ||
| user.subaccount.delete | |
|
|
|
no | 리셀러 서브계정 삭제 | ||
| user.subaccount.edit | |
|
|
|
no | 리셀러 서브계정 데이터 업데이트 | ||
| user.subaccount.get | |
|
|
|
no | 리셀러 서브계정 상세 정보 확인 | ||
| user.subaccount.getPurchasedContents | |
|
|
|
no | 서브계정에 의한 구매내역 확인 | ||
| media.getLicense | |
|
|
|
no | 개별 거래에 대한 리셀러-구매자 라이센스 | ||
Query Format
HTTP
The Fotolia API is a REST API, available via standard HTTP calls, using the method GET for read-only methods, the method POST for methods that modify data or log the user in, and the standard query string to pass arguments.
More information about REST.
To use the REST API, each request must be sent using your API key as the HTTP username, and either an empty string (for public methods) or a session token (for methods that require authentication) as the HTTP password.
Base URL
The base URL for the REST API is: http://api.fotolia.com/Rest/1/
Return format
The data returned by the REST API is formatted in JSON, a format that can be parsed with most modern programming languages.
More information about JSON.
Query Example
In this example, we call the method main/test with the API key 'exampleApiKey' as the HTTP username, and an empty HTTP password since the method is public. The authorization header thus uses the base64 encoded string 'exampleApiKey:'.
GET /Rest/1/main/test HTTP/1.0
Host: api.fotolia.com
Authorization: Basic ZXhhbXBsZUFwaUtleTo=
Methods that are called using GET may also be called directly by URL, so URL in this example would be: http://exampleApiKey:@api.fotolia.com/Rest/1/main/test
Response Example
{
"test":"Success"
}
API Kits
You can use a kit in order to help simplify API use. A list of kits available is listed below. Please contact us to have your kit listed.
