L

はじめる

アカウント作成から最初のAPIリクエストまで、所要5分。

  1. 1

    無料アカウントを作成する

    新規登録から。クレジットカードは不要です。作成するとダッシュボードに入れます。
  2. 2

    LINE公式アカウントを接続する

    Lokuのプロジェクトは、LINE公式アカウント1つに対応します。持っていなければ LINE公式アカウント (無料) を数分で作れます。接続後、自分を友だち追加しておくと実際の挙動をひととおり試せます。
  3. 3

    APIキーを発行する

    ダッシュボードの 開発者 > APIキー を開き、「APIキーを作成」。キーは lk_ で始まる文字列で、発行時に1回だけ表示されます。スコープ (権限) はリクエストに必要な最小だけを選びます — 読むだけなら friends:read のような :read 系だけで十分です。
  4. 4

    最初のリクエストを送る

    curl "https://l.oku-ai.co.jp/api/v1/friends?limit=1" \
  -H "Authorization: Bearer lk_xxxxxxxxxxxx"
    成功するとJSONが返ります:
    {
  "data": [
    {
      "id": "01ABC...",
      "lineUserId": "U1234...",
      "displayName": "山田 太郎",
      "status": "following",
      "score": 82,
      "followedAt": "2026-07-01T00:00:00.000Z",
      "messageCount": 12,
      "createdAt": "2026-07-01T00:00:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 1, "total": 152, "totalPages": 152 }
}
  5. 5

    イベントを受け取る (任意)

    開発者 > Webhook でエンドポイントを登録すると、友だち追加や予約確定があなたのサーバーに届きます。登録後の「テスト送信」ボタン (test.ping) で疎通確認できます。詳しくは Webhook へ。

つまずいたら

401 Unauthorizedキーの打ち間違いのほか、店舗のプランがProプラン未満の場合もこれです。キーの発行は無料ですが、実データの読み書きはProプラン以上で有効になります。
403 Insufficient scopeキーに必要なスコープが付いていません。必要スコープは各エンドポイントのリファレンスに書いてあります。
429300リクエスト/分の上限に達しています。間隔を空けて再試行してください。

APIリファレンス

全エンドポイントの引数・レスポンス・エラー

Webhook

イベント14種・署名検証・再試行の仕様