monoicon

API Docs (v1)

v1 APIの旧ドキュメントです。最新のドキュメントは API Docs を参照してください。

GET /api/v1/icon

指定した1色で塗りつぶした正方形の画像をレスポンスします。

QUERY PARAMETERS

colorstring必須

6桁のHEXカラー(例: e0719a, #e0719a)

sizeinteger任意

1〜2048の整数。既定値は512

formatstring任意

png / jpeg / webp / jxl(非推奨)のいずれか。既定値はpng

downloadflag任意

付与するとContent-Disposition: attachmentで応答

RESPONSE

画像バイナリ(image/png, image/jpeg, image/webp, image/jxl)をレスポンスします。Cache-Control: public, max-age=31536000, immutableが付与されます。パラメータが不正な場合は400と以下のいずれかのメッセージをレスポンスします。

  • Invalid color: expected 6-digit hex
  • Invalid size: expected integer between 1 and 2048
  • Invalid format: expected png, jpeg, webp or jxl

EXAMPLE

curl -o icon.png "https://monoicon.mq1.dev/api/v1/icon?color=e0719a&size=512&format=png"
#cbe3f5#bdc1f0#c1bfed#c8c1ee

* 本APIで生成した画像

GET /api/v1/palette

ランダムパレット12色と初期選択色をレスポンスします。パラメータはありません。

RESPONSE

{
	"colors": [
		"#f6d8d2", "#f3e2d7", "#bfebda", "#c7eadf",
		"#bbecf0", "#ced5f1", "#d6d7f7", "#e0d6f2",
		"#dbc8f0", "#f0d4e5", "#edc7cb", "#f2ddde"
	],
	"initial": "#bfebda"
}