Icons8 API로 웹 페이지에 아이콘을 임베드하고 렌더링할 수 있습니다.
현재, 아이콘을 렌더링하려면 API 키를 통한 인증이 필요합니다. 단 무료 아이콘(100px 미만의 PNG)은 예외로 인증 없이 렌더링 가능합니다.
아이콘을 요청하는 방법에는 다음 두 가지가 있습니다.
기본 링크는 다음과 같습니다:
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)하여 구분합니다. |