메인 콘텐츠로 건너뛰기
모든 콜렉션
Icons8 API로 아이콘 렌더링하기
Icons8 API로 아이콘 렌더링하기
Maria avatar
작성자: Maria
최소 8달 전에 업데이트됨

Icons8 API로 웹 페이지에 아이콘을 임베드하고 렌더링할 수 있습니다.

현재, 아이콘을 렌더링하려면 API 키를 통한 인증이 필요합니다. 단 무료 아이콘(100px 미만의 PNG)은 예외로 인증 없이 렌더링 가능합니다.

아이콘을 요청하는 방법에는 다음 두 가지가 있습니다.

1) 아이콘의 ID를 지정합니다. ID는 이곳이곳에 설명된 대로 두 번째 API를 통해 수신할 수 있습니다.

기본 링크는 다음과 같습니다:

GET https://api-img.icons8.com/?token=user_token&id=icon_id

이는 기본 매개변수를 적용한 아이콘을 반환합니다.

& 문자로 구분된 쿼리-매개변수를 추가하여 속성을 변경할 수 있습니다.

token - 필수 - API 키

icon_id - 필수 - 위의 코드 참조

size - 옵션 - 정의되지 않으면 가장 높은 해상도로 반환함. 픽셀 크기(예: 512) 또는 배수(예: 2x, 3x 등)로 표현

format - 옵션 - 정의되지 않으면 .PNG를 반환함. 그밖에 .PNG, .SVG, .PDF, .GIF, .AEP .JSON으로 지정 가능

color - 옵션 - HEX로 표기(# 문자 생략)하며 단색 아이콘에서만 사용 가능

예를 들어, 점선 스타일의 512px 빨간색 HDD .svg 아이콘을 불러올 때의 요청은 다음과 같습니다.

GET https://api-img.icons8.com/?token=user_token&id=44082&size=512&format=svg&color=FF2400

필수 매개변수를 정의하지 않으면 에러를 반환합니다. 그러나 쿼리-매개변수의 순서는 중요하지 않습니다.


2) 아이콘의 구체적인 스타일이름을 지정합니다.

매개변수는 다음과 같이 슬래시로 구분합니다:

GET https://api-img.icons8.com/platform/size/color/name.format?token=user_token

token - 필수 - API 키

name - 필수 - 검색 요청을 통해 수신됨

platform - 옵션 - 디폴트로 iOS7-style을 반환함. 스타일 이름은 API를 통해 요청되거나 스타일 별로 검색할 때 주소창에 표시됩니다.

format - 옵션 - 정의되지 않으면 .PNG를 반환함. 그밖에 .PNG, .SVG, .PDF, .GIF, .AEP .JSON으로 지정 가능

color - 옵션 - HEX로 표기(# 문자 생략)하며 단색 아이콘에서만 사용 가능

예를 들어, 머티리얼 외곽선 스타일의 128px 빨간색 열쇠 .svg 아이콘을 불러올 때의 요청은 다음과 같습니다.

GET https://api-img.icons8.com/material-outlined/128/2AE468/key-security.svg?token=user_token

아이콘 또는 스타일 이름이 둘 이상의 단어로 구성되어 있으면 하이픈을 사용(예: left-arrow)하여 구분합니다.

답변이 도움되었나요?