🔐 KantanBiz の「API アクセストークン」って何ができる？｜具体例つき
kantan
こんにちは。KantanBiz の プロフィール → API アクセストークン を開いたとき、「これで一体何ができるの？」と思った方も多いはずです。今日は できること を整理し、イメージしやすい例 をいくつか挙げます。✨
そもそも「トークン」は何のため？🤔
このトークンは、ブラウザでログインしなくても、**プログラムから KantanBiz の API を呼ぶための「鍵」**です。🔑
- リクエストには
Authorization: Bearer（あなたのトークン）が必要 - どのオフィス（テナント）向けかは
X-Tenant-Idで指定
というイメージです。画面の説明にあるとおり、POST /api/v1/auth/token でパスワードの代わりにパスコードを送って取るトークンと 同じ種類 のものとして扱われます。
できることのイメージ（シーン別）🚀
📇 取引先・部門を「別システムと同期」したい
CRM や社内 DB に取引先があるなら、API で取引先・部門を作成・更新できます。マスタの二重管理を減らしたいときに向いています。🔄
🏭 仕入先リストを「一括で入れたい」
Excel や別アプリから 仕入先やスキル をまとめて登録する、といった運用も想定できます。📥
📦 サービス（メニュー）を「外部からメンテしたい」
料金やメニュー名を、社内の別ツールやスクリプトから サービス API で更新する、という使い方もできます。🛠️
📋 案件・明細まで「自動で流し込みたい」
受注データがあるなら、案件の作成に加え、請求明細・原価明細まで API で送れます。バックオフィスの手入力を減らす用途です。⏱️
🔔 Webhook を「API から設定したい」
連携先 URL の登録や ping での疎通確認 も API 経由で行えます。運用を自動化したいチーム向けです。📡
📄 PDF の見た目を「スクリプトで揃えたい」
PDF ブランディングの取得・更新も可能です。ブランドガイドに合わせて一括反映したいときに便利です。🎨
注意しておきたいこと ⚠️
- トークンは パスワードと同じくらい大事 な秘密情報です。Git やチャットに貼らないでください。🙅
- 発行できるのは 有料プランのオーナー に限られる、という制限があります（画面の案内どおり）。
- メール認証が済んでいないと発行できない 場合があります。
まとめ ✨
API アクセストークンは、KantanBiz の 顧客・仕入先・サービス・案件・明細・Webhook・PDF ブランディング などを、プログラムから安全に操作するための鍵です。🔐
「自社のワークフローに KantanBiz を組み込みたい」「手入力を減らしたい」というときの第一歩になります。まずは テスト用のトークン名 を付けて発行し、読み取り系の API から試すのがおすすめです。🌱
