Icons8では、APIを利用してウェブページにアイコンを埋め込み、レンダリングすることができます。
アイコンのレンダリングには、無料アイコン(100px以下の.png)を除き、APIキーによる認証が必要となります。
アイコンをリクエストするには2つの方法があります:
基本的なURLは以下の通り:
GET
https://api-img.icons8.com/?token=user_token&id=icon_id
この場合、デフォルトのパラメータを適用したアイコンが返却されます。
クエリパラメーターは URL に &文字で区切りで追加できます:
token
- 必須 - あなたのAPI キー
icon_id
- 必須 - 上記のリンクを参照
size
- オプション - 指定がない場合、ピクセルパーフェクトのアイコンが返されます。ビクセル数値 (512 など) と倍数 (2x、3x など) のどちらでも指定可能です。
format
- オプション - 指定がない場合は PNG で返されます。レンダラーは .PNG, .SVG, .PDF, .GIF, .AEP, .JSON 形式をサポートしています。
color
- オプション - HEX (#は付けない)で指定します。モノクロアイコンにのみ有効です。
赤色で 512px HDD .svg アイコンを Dotty スタイルで取得する場合のリクエスト例は、次のようになります:
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 key.
name
- 必須 - 検索リクエストから取得可能です。
platform
- オプション - デフォルトでは、iOS7 スタイルのアイコンが返されます。スタイル名は API経由でリクエストするか、スタイルをブラウズするときにアドレスバーに表示されています。
format
- オプション - 指定がない場合 .PNG で返されます。レンダラーは .PNG, .SVG, .PDF, .GIF, .AEP, .JSON 形式をサポートしています。
color
- オプション - HEX (#は付けない) で指定します。モノクロアイコンにのみ有効です。
緑色で 128px の Key .svgアイコンをMaterial Outlinedスタイルで入手するには、次のようにリクエストしてください:
GET https://api-img.icons8.com/material-outlined/128/2AE468/key-security.svg?token=user_token
アイコンやスタイル名が2つ以上の単語で構成されている場合は、ハイフンで区切ってください。例:left-arrow