ログイン無料で始める

クイックスタート

このガイドでは、Personal API Token を使って 5 分で最初のプランを登録 する手順を説明します。

前提条件

  • Nolto のアカウント（無料登録）
  • ターミナル（curl が使えること）

Step 1: API トークンを発行する

  1. Nolto にログインします。
  2. 設定 > API トークン ページを開きます。
  3. 「新規発行」 をクリックし、トークン名を入力します。
  4. 表示されたトークン（nolto_user_ で始まる文字列）をコピーします。
⚠️

トークンは 作成時に一度だけ 表示されます。必ずコピーして安全な場所に保存してください。

以降の例では、トークンを環境変数にセットして使います:

export VIDOCS_TOKEN="nolto_user_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Step 2: プロジェクト一覧を取得する

curl -s -H "Authorization: Bearer $VIDOCS_TOKEN" \
  https://nolto.app/api/projects | jq .

レスポンス例:

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "my-app",
      "description": "メインのWebアプリ",
      "role": "owner",
      "plans": []
    }
  ]
}

プロジェクト ID を控えておきます:

export PROJECT_ID="550e8400-e29b-41d4-a716-446655440000"
💡

プロジェクトがまだない場合は POST /api/projects で作成できます。 詳しくは REST API リファレンス を参照してください。

Step 3: プランを登録する

curl -s -X POST \
  -H "Authorization: Bearer $VIDOCS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": {
      "title": "商品検索機能の改善",
      "content": "## 概要\n商品検索機能を改善する。\n\n## タスク\n1. 検索インデックスを最適化\n2. オートコンプリート UI を実装\n3. 検索結果のランキングを調整",
      "status": "in_progress"
    }
  }' \
  "https://nolto.app/api/projects/$PROJECT_ID/plans" | jq .

レスポンス例:

{
  "planId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "transformStatus": "queued",
  "detailUrl": "https://nolto.app/projects/550e.../plans/7c9e..."
}

Step 4: 結果を確認する

レスポンスの detailUrl をブラウザで開くと、登録されたプランの詳細画面が表示されます。

LLM による変換（AI サマリの生成）はバックグラウンドで自動的に実行され、数分で完了します。変換後は、技術的な実装プランが非エンジニア向けの日本語サマリに書き換えられます。

次のステップ