플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Flickr 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
Flickr 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | media_type, sort | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $24 | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
user_posts사용자 게시물
| user_id | author_id, media_type, sort, username | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $24 | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
Flickr search 파라미터는 각각 무엇을 의미하나요?
keyword와 일치하는 Flickr 사진이나 동영상을 검색합니다. 제목, 이미지 링크, 태그, 사진가 이름과 ID, 촬영일, 업로드일을 가져옵니다. taken_at은 EXIF에서 가져오므로 비어 있을 수 있고 업로드 시간과 다릅니다. 링크가 있다고 재사용 권한이 생기지는 않습니다.
keyword필수- search 액션에서 사진 또는 동영상 검색어를 지정합니다. 반환되는 미디어 범위는 media_type으로 제어하며, 이 파라미터로 작성자 표시 이름을 정확히 일치하는 방식으로 조회하지는 않습니다.
media_type선택- 미디어 범위를 필터링하며, 허용 값은 photos(사진만), videos(동영상만), all(모든 미디어)입니다. 기본값은 search에서 photos, user_posts에서 all입니다. 이 파라미터는 조회 필터링을 제어하며, 원본 파일 다운로드 여부를 결정하지 않습니다.Flickr: 미디어 유형은 콘텐츠 라이선스와 별개 — Flickr는 미디어 유형 정의와 라이선스 분류를 명확히 구분합니다. EveryInfra는 현재 `media_type` 파라미터를 제공하지만 공식 라이선스 파라미터는 제공하지 않습니다. 검색으로 사진이나 동영상을 가져왔다고 해서 해당 자산의 이용 권한이 생기는 것은 아닙니다. · 확인일
sort선택- search(기본값 relevance)와 user_posts(기본값 date-posted-desc)에서 사진과 동영상의 정렬 순서를 지정합니다. 지원되는 값은 relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc, date-taken-asc입니다. 업로드 날짜(date-posted)와 촬영 날짜(date-taken)는 서로 다른 속성이므로 바꿔 사용할 수 없습니다.Flickr: 촬영일 기준 정렬과 게시일 기준 정렬의 차이 — Flickr 문서는 촬영일(date-taken) 기준 정렬과 게시일(date-posted) 기준 정렬을 구분합니다. 이는 시간 관련 의미를 명확히 해 주지만, 이 엔드포인트의 기본값, 지원 파라미터, 최대 결과 수는 EveryInfra 문서에 기재된 내용을 따르며 공식 API의 모든 기능을 그대로 반영하지는 않습니다. · 확인일
Flickr user_posts 파라미터는 각각 무엇을 의미하나요?
user_id에 NSID를 넣어 Flickr 회원의 사진과 동영상을 나열합니다. 제목, 이미지 링크, 태그, 촬영일, 업로드일을 가져옵니다. 표시 이름이 아닌 검색 결과의 author_id에 있는 NSID를 전달하세요. 비공개 앨범은 포함되지 않습니다.
user_id필수- 대상 Flickr 사용자의 NSID를 지정합니다(예: 12345678@N04). 검색 결과의 author_id 필드에서 가져올 수 있습니다. 표시 이름, 사용자 지정 프로필 별칭, 프로필 전체 URL은 받지 않습니다.Flickr: 사용자 NSID의 의미 — Flickr 문서는 `user_id`를 사용자 NSID로 정의하며, 이는 화면에 표시되는 이름이나 사용자 지정 프로필 URL 경로와 다릅니다. 이 정의가 EveryInfra가 사용자의 비공개 사진에 접근할 수 있다는 뜻은 아닙니다. · 확인일
media_type선택- 미디어 범위를 필터링하며, 허용 값은 photos(사진만), videos(동영상만), all(모든 미디어)입니다. 기본값은 search에서 photos, user_posts에서 all입니다. 이 파라미터는 조회 필터링을 제어하며, 원본 파일 다운로드 여부를 결정하지 않습니다.
sort선택- search(기본값 relevance)와 user_posts(기본값 date-posted-desc)에서 사진과 동영상의 정렬 순서를 지정합니다. 지원되는 값은 relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc, date-taken-asc입니다. 업로드 날짜(date-posted)와 촬영 날짜(date-taken)는 서로 다른 속성이므로 바꿔 사용할 수 없습니다.
username선택- user_posts에서 사용하는 user_id의 호환용 별칭입니다. 사람이 읽을 수 있는 표시 이름이 아닌 유효한 Flickr NSID가 필요하며, 공개 user_posts 요청에는 여전히 필수 파라미터인 user_id를 포함해야 합니다.
Flickr API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"flickr","action":"search","params":{"keyword":"<keyword>"}}'
Flickr API 자주 묻는 질문
Flickr API로 무엇을 가져올 수 있나요?
platform을 flickr 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색 및 사용자 게시물입니다. 각 액션 이름은 서로 다른 Flickr 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Flickr search 요청에는 어떤 입력이 필요한가요?
search 액션에서 사진 또는 동영상 검색어를 지정합니다. 반환되는 미디어 범위는 media_type으로 제어하며, 이 파라미터로 작성자 표시 이름을 정확히 일치하는 방식으로 조회하지는 않습니다. params 안의 keyword 필드로 전달하세요.
Flickr search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, image_url, media_type 및 author_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Flickr 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.