はじめに

ゼロから最初の JSON まで 5 分。immit アカウント、キー、curl、エントリー。

1. アカウントとキーを作る

   immit にサインインし、コンソールを開いてキーを作成します。名前はそのキーを保持するものに合わせてください。シークレットは一度だけ表示され、コンソールに残るのは先頭 12 文字だけです。ダイアログを閉じる前にシークレットストアへコピーしてください。

2. /v1/me を呼ぶ

   すべてのリクエストはキーをベアラートークンとして送ります。最初の呼び出しでキーが有効なことを確かめ、アカウントのティアとクォータを確認できます。

   curlJavaScriptPython

   コピー

   curl 'https://api.immit.co/v1/me' \
     -H "Authorization: Bearer $IMMIT_API_KEY"

   200 · application/json

   {
     "id": "5da1679e-9276-4409-8f7d-9ae52eac1f50",
     "name": "My app",
     "prefix": "ik_live_7XOk",
     "tier": "free",
     "inserted_at": "2026-11-03T23:58:33.778440Z",
     "today": {
       "requests": 1,
       "day": "2026-11-03",
       "remaining": 999
     },
     "quota": {
       "requests_per_day": 1000,
       "requests_per_minute": 60
     },
     "last_used_at": "2026-11-03T23:58:33.816368Z"
   }

   • x-ratelimit-limit: 60
   • x-ratelimit-remaining: 59
   • x-ratelimit-reset: 27
   • x-quota-limit: 1000
   • x-quota-remaining: 999
   • x-quota-reset: 86

3. 単語を引く

   見出し語は UTF-8 をパーセントエンコードしたものです。大文字小文字だけが違う見出し語や、同じ語の別表記はそのエントリーに解決され、正規の見出し語がレスポンスで返ります。

   curlJavaScriptPython

   コピー

   curl 'https://api.immit.co/v1/dictionary/jpn/entries/食べる' \
     -H "Authorization: Bearer $IMMIT_API_KEY"

   200 · 抜粋

   {
     "id": "9bebf0ab-36ee-4511-a271-f8d0a21efe31",
     "headword": "食べる",
     "lang": "jpn",
     "frequency_rank": 293,
     "pronunciations": [
       {
         "reading": "たべる",
         "accent": 2,
         "sounds": [
           {
             "mp3_url": "https://storage.immit.co/sounds/01M45PR236JEQ21RS26407FZ32.mp3",
             "voice": "Himari",
             // …
           }
         ],
         // …
       }
     ],
     "senses": [
       {
         "pos": "動詞",
         "definition": "食物を口に入れ、かんで飲み込む。",
         "translations": {
           "eng": {
             "qualifier": null,
             "glosses": [
               {
                 "text": "to eat",
                 "readings": []
               },
               {
                 "text": "to have (a meal)",
                 "readings": []
               }
             ]
           }
         },
         // … homograph, pos_translations, examples, ids
       },
       // … 1 more sense
     ],
     "inflections": [
       {
         "text": "食べます",
         "form": "現在形",
         "tone": "polite",
         "polarity": "positive",
         // …
       },
       // … 42 more rows
     ],
     // … spellings, relations, updated_at
   }

4. 検索する

   クエリは見出し語の前方一致、活用形の表層形、日本語では読みにもマッチします。食べました は 食べる を見つけ、たべ でも見つかります。並び順は immit 自身のランキングで、アプリと同じものです。

   curlJavaScriptPython

   コピー

   curl 'https://api.immit.co/v1/dictionary/jpn/entries?query=たべ&limit=3' \
     -H "Authorization: Bearer $IMMIT_API_KEY"

   200 · 抜粋

   {
     "metadata": {
       "after": null,
       "before": null,
       "limit": 3
     },
     "entries": [
       {
         "id": "9bebf0ab-36ee-4511-a271-f8d0a21efe31",
         "headword": "食べる",
         "lang": "jpn",
         "frequency_rank": 293,
         // … the full entry
       },
       {
         "id": "9323df1f-0ad8-4b00-9e7c-275da917e3d4",
         "headword": "たべっ子どうぶつ",
         "lang": "jpn",
         "frequency_rank": 107140,
         // … the full entry
       },
       {
         "id": "c7c50b63-cd93-4a09-9c9e-b737df9cccec",
         "headword": "食べつわり",
         "lang": "jpn",
         "frequency_rank": 160361,
         // … the full entry
       }
     ]
   }

5. ヘッダーを読む

   制限は 2 つで、どちらもアカウントのすべてのキーを合わせて数えます。1 分あたりのバーストと、UTC の 1 日あたりのクォータです。どのレスポンスにも現在地が載ります。どちらかを超えると retry-after 付きの 429 が返り、拒否されたリクエストは数えられません。表はレート制限とクォータにあります。

次に読むもの