# Rakugaki

> A small collection of hand-drawn doodle characters (59 characters x 6 expressions = 354 transparent PNG images, 720x880). Everything is available through a read-only JSON API with no authentication. CORS is open (Access-Control-Allow-Origin: *).

The site is in Japanese (らくがきをあつめたよ = "a collection of doodles"). Character names and settings in the API are Japanese; ids are ASCII. Each character has a number (`no`, shown as No.001).

## Usage

- The images are free to use for both commercial and non-commercial purposes.
- Commercial use: allowed. Credit / attribution: not required. Modification and redistribution: allowed.
- [About this site (Japanese)](https://rakugaki.mori22.com/about): overview, usage terms and API docs

## API

- [List all characters](https://rakugaki.mori22.com/api/characters): `GET /api/characters` returns `{ expressions: [{ id, label }], groups: [{ id, label }], characters: [{ id, no, group, name, setting, kana, images: { <expression>: <absolute PNG URL> } }] }`
- [Get one character](https://rakugaki.mori22.com/api/characters/maru): `GET /api/characters/{id}` returns one character object, or 404 `{ "error": ... }`
- [Get an image](https://rakugaki.mori22.com/api/characters/maru/normal): `GET /api/characters/{id}/{expression}` returns `image/png` (720x880, transparent background), or 404
- [Get a random character](https://rakugaki.mori22.com/api/random): `GET /api/random` returns one random character object (not cached)
- [Get a random image](https://rakugaki.mori22.com/api/random/image): `GET /api/random/image` returns a random character with a random expression as `image/png`. Fix the expression with `?expression={id}`. Which one was chosen is in the response headers `X-Rakugaki-Character` and `X-Rakugaki-Expression`
- [OpenAPI 3.1 definition](https://rakugaki.mori22.com/openapi.json)
- [Human-readable API docs (Japanese)](https://rakugaki.mori22.com/about#api)

## Fetching images

The cheapest way is the static URL `https://rakugaki.mori22.com/images/{id}_{expression}.png` (also returned in `images` by the JSON API). The `/api/characters/{id}/{expression}` endpoint returns the same bytes.

Example: `curl -o maru_happy.png https://rakugaki.mori22.com/images/maru_happy.png`

## Expressions

- `normal`: 通常
- `happy`: 喜び
- `angry`: 怒り
- `sad`: 悲しみ
- `surprised`: 驚き
- `confused`: 困惑

## Characters

### 図形の頭 (`shape`)

- `maru` (No.001 まる): いちばん最初に生まれたらくがき。まんまるの頭。
- `kaku` (No.002 しかく): まじめで几帳面なしかく。角の丸い四角の頭。
- `sankaku` (No.003 さんかく): とがったことが好きなさんかく。上向きの三角の頭。
- `heart` (No.004 はーと): 気持ちがすぐ顔に出るはーと。ハートの形の頭。
- `rokkaku` (No.005 ろっかく): 工具箱から出てきたろっかく。ナットのような六角形の頭。
- `gokaku` (No.006 ごかく): どっしり構えたごかく。上向きの五角形の頭。
- `shizuku` (No.007 しずく): 雨上がりに生まれたしずく。上がとがったしずく形の頭。
- `kamaboko` (No.008 かまぼこ): お正月が待ちきれないかまぼこ。下が平らな半円の頭。
- `hishigata` (No.009 ひしがた): きらりと光りたいひしがた。縦長のひし形の頭。
- `tamago` (No.010 たまご): 割れないように気をつけているたまご。上が少し細い卵形の頭。
- `kumo` (No.011 くも): ふわふわ浮かんでいたいくも。もこもこの雲の形の頭。
- `hana` (No.012 はな): 日なたが好きなはな。花びら 5 枚の形の頭。

### 職業 (`job`)

- `chef` (No.013 シェフ): 町の小さな食堂の料理人。ふくらんだコック帽と赤いスカーフ。
- `detective` (No.014 探偵): 町の小さな事件を追う探偵。鹿撃ち帽とベージュのトレンチコート。
- `astronaut` (No.015 宇宙飛行士): 帰り道を探している宇宙飛行士。ガラスのヘルメットと胸の操作パネル。
- `doctor` (No.016 お医者さん): 町の小さな診療所のお医者さん。おでこの額帯鏡と白衣、首の聴診器。
- `nurse` (No.017 看護師): 夜勤明けの看護師。ナースキャップと水色の制服。
- `police` (No.018 おまわりさん): 交番のおまわりさん。記章つきの制帽と紺の制服。
- `firefighter` (No.019 消防士): 新人の消防士。赤いヘルメットと反射帯の入った防火服。
- `postman` (No.020 郵便屋さん): 坂の多い町の郵便配達員。制帽と斜めがけの赤い郵便かばん。
- `carpenter` (No.021 大工): 棟梁見習いの大工。ねじり鉢巻と腰の道具ベルト。
- `farmer` (No.022 農家): 野菜づくり一筋の農家。麦わら帽子とオーバーオール。
- `fisher` (No.023 漁師): 港町の漁師。黄色い雨帽子と雨合羽、長靴。
- `baker` (No.024 パン屋): 朝 4 時に起きるパン屋。三角巾と粉のついたエプロン。
- `painter` (No.025 画家): 売れない画家。ベレー帽と絵の具だらけのスモック。
- `scientist` (No.026 博士): 実験好きの博士。ぼさぼさの白髪とおでこのゴーグル、白衣。
- `teacher` (No.027 先生): 小学校の先生。丸めがねとカーディガン。
- `pilot` (No.028 パイロット): 雲の上が好きなパイロット。翼章つきの帽子と紺の制服。
- `captain` (No.029 船長): 古い客船の船長。白い船長帽と金ボタンの紺の上着。
- `conductor` (No.030 車掌): ローカル線の車掌。制帽と斜めがけのかばん、胸の切符ばさみ。
- `librarian` (No.031 司書): 本の虫の司書。まとめ髪とカーディガン、胸の名札。
- `reporter` (No.032 新聞記者): 特ダネを追う新聞記者。PRESS の札つきの中折れ帽とベスト。
- `maid` (No.033 メイド): お屋敷のメイド。フリルのカチューシャと白いエプロン。
- `magician` (No.034 手品師): 小さな劇場の手品師。鳩が顔を出すシルクハットと赤い蝶ネクタイ。
- `gardener` (No.035 庭師): バラ園の庭師。つばの広い帽子と緑のエプロン。
- `barista` (No.036 バリスタ): 小さな喫茶店のバリスタ。ハンチング帽と茶色のエプロン。
- `photographer` (No.037 写真家): 旅する写真家。キャップと首から下げたカメラ。
- `mechanic` (No.038 整備士): 町工場の整備士。つなぎとおでこの油汚れ。
- `guard` (No.039 交通誘導員): 工事現場の交通誘導員。白いヘルメットと黄色の反射ベスト。
- `lifeguard` (No.040 ライフガード): 海の見張り番。サンバイザーと赤いシャツ、首の笛。
- `hairdresser` (No.041 美容師): 流行に敏感な美容師。おしゃれな髪型と黒いエプロン。
- `florist` (No.042 花屋): 駅前の花屋の店員。バンダナと花柄のエプロン、胸の一輪の花。
- `sailor` (No.043 水兵): 港に帰ってきた水兵。セーラー帽とセーラー襟、赤いスカーフ。
- `judge` (No.044 裁判官): 公正な裁判官。白い巻き毛のかつらと黒い法服。
- `dj` (No.045 DJ): 夜の DJ。大きなヘッドホンと黒い T シャツ。

### スポーツ (`sports`)

- `baseball` (No.057 野球選手): 4 番打者の野球選手。キャップと背番号のユニフォーム。
- `soccer` (No.058 サッカー選手): 点取り屋のサッカー選手。ヘアバンドと縦じまのユニフォーム。
- `judoka` (No.059 柔道家): 黒帯の柔道家。白い道着と黒帯。
- `sumo` (No.060 お相撲さん): 新入幕のお相撲さん。大銀杏とまわし。
- `boxer` (No.061 ボクサー): 世界を目指すボクサー。赤いヘッドギアとトランクス、肩のタオル。
- `runner` (No.062 ランナー): 市民マラソンのランナー。鉢巻とゼッケン。
- `cyclist` (No.063 サイクリスト): 峠を越えるサイクリスト。流線形のヘルメットとジャージ。
- `skier` (No.064 スキーヤー): 雪山のスキーヤー。ニット帽とおでこのゴーグル、マフラー。
- `referee` (No.065 審判): 公平な審判。白黒しまのシャツと首の笛。
- `jockey` (No.066 騎手): 新人の騎手。丸いヘルメットと色分けの勝負服。

### ファンタジー (`fantasy`)

- `king` (No.068 王様): 小さな国の王様。金の王冠と、白い毛皮で縁取った赤いマント。
- `wizard` (No.069 魔法使い): 見習い中の魔法使い。先の曲がったとんがり帽子と紺のローブ。
- `pirate` (No.070 海賊): 宝の地図をなくした海賊。ドクロの三角帽と赤白ボーダーのシャツ。

### 和風 (`japanese`)

- `ninja` (No.082 忍者): 修行中の忍者。結び目のある頭巾と黒装束。

## Notes

- Valid expression ids: normal, happy, angry, sad, surprised, confused. Unknown ids return 404.
- Read-only. No rate limit is documented, but please cache responses (images are served with Cache-Control: max-age=86400).