🔐 KantanBiz の「API アクセストークン」って何ができる？｜具体例つき

こんにちは。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 から試すのがおすすめです。🌱