Loglass

Loglass API概要とfreee・OBC連携手順ガイド

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

API キーの取得方法

API キーは Loglass の公式ポータル（管理画面 → 開発者向け）から発行できます。以下の手順で取得してください。

  1. ログイン – 管理者権限を持つユーザーで Loglass にサインインします。
  2. 開発者メニューへ移動 – 画面左側メニューの「設定」→「API 管理」を選択します。
  3. キーの生成 – 「新規 API キー作成」ボタンをクリックし、キー名と利用目的（例：予算データ連携）を入力します。
  4. 保存・確認 – 生成された文字列が API キーです。画面に一度だけ表示されるため、必ずコピーして安全な場所に保管してください。

ポイント：API キーは英数字で構成された 約32文字 の文字列です（公式ドキュメントでは「長さは 30〜34 文字の可変長」と記載）。紛失した場合は同メニューから削除し、再発行してください。

権限設定と利用条件

Loglass API では スコープ によってアクセス権が決まります。キー作成時に必要なスコープを選択し、プランごとの呼び出し上限と有効期限を確認しましょう。

スコープ 説明 標準プラン（月間上限） エンタープライズプラン
read データ取得のみ許可 10,000 回 無制限
write データ登録・更新を許可 5,000 回 無制限
  • 有効期限 – 発行されたキーは 90 日（※公式ドキュメント 2026‑07‑01 更新）で自動失効します。ローテーションスクリプトの実装が推奨されます。
  • ロールベース制御 – 必要に応じて「読み取り専用」または「書き込み可能」のどちらかを選択できます。

参考情報：最新の呼び出し上限や有効期限は Loglass 開発者ポータルの API 利用条件 ページ（公式ドキュメント）で随時確認してください。

freee 会計との API 連携手順

freee が提供する OAuth2.0 認可フローを利用して、Loglass の予算・実績データを freee に自動取込む方法を解説します。本機能は 2026 年 7 月時点で本番提供中 です（2024 年リリースの情報は公式発表が無いため除外しました）。

OAuth2.0 認証とトークン管理

OAuth2.0 による認可は、以下の流れで行います。各エンドポイントは freee の最新 API ドキュメント（2026‑06‑30 更新）に基づいて記載しています。

  1. アプリ登録 – freee デベロッパーポータルで「新規アプリ」を作成し、リダイレクト URL（例: https://your-company.com/callback）を設定します。
  2. クライアント情報取得 – 発行された Client ID と Client Secret を安全な場所に保管し、環境変数などで管理します。
  3. 認可コード取得 – ユーザーを下記 URL にリダイレクトし、code パラメータを受け取ります（スコープは accounting が必須）。

text
https://accounts.freee.co.jp/public_api/authorize?
response_type=code&
client_id={CLIENT_ID}&
redirect_uri={REDIRECT_URI}&
scope=accounting

  1. アクセストークン取得 – 認可コードを受け取ったら、以下の POST リクエストでトークンへ交換します。

http
POST https://accounts.freee.co.jp/public_api/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&
code={AUTH_CODE}&
redirect_uri={REDIRECT_URI}&
client_id={CLIENT_ID}&
client_secret={CLIENT_SECRET}

  1. トークン保管とリフレッシュ – 取得した access_token（有効期限は 1 時間）と refresh_token を暗号化されたデータベースに保存し、期限が近づいたら下記エンドポイントで自動更新します。

http
POST https://accounts.freee.co.jp/public_api/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&
refresh_token={REFRESH_TOKEN}&
client_id={CLIENT_ID}&
client_secret={CLIENT_SECRET}

ポイント：トークンの有効期限は公式ドキュメントで「最大 60 分」と記載されています。リフレッシュ処理を 55 分目 に実行すると、認証エラーを防げます。

データマッピング例：予算・実績の自動取込

以下は Loglass のデータ構造と freee が受け付ける JSON フィールドの対応表です。マッピングは freee API バージョン 1.0（2026‑07‑10 更新）に合わせています。

Loglass フィールド freee API フィールド 補足
budget_year fiscal_year 数値（例: 2024）
department_id department_code 文字列、最大 10 桁
account_item_id account_item_id 同一 ID が前提
planned_amount amount_planned 円単位整数
actual_amount amount_actual 円単位整数

サンプル JSON（予算データ送信）

POST エンドポイント例（予算作成）

エラーハンドリングとログ出力

ステータスコード 主な原因 推奨対処
400 リクエスト構文エラー JSON キー・型を再確認
401 トークン無効または期限切れ リフレッシュ／再取得
403 スコープ不足 accounting スコープを付与
429 呼び出し上限超過 バックオフ実装、プラン見直し
5xx freee 側サーバ障害 指数バックオフで再試行

ログ例（loglass-integration.log）

勘定奉行クラウド（OBC）との API 連携手順

OBC（勘定奉行クラウド）は Client Credentials フローを採用しており、サーバ間でトークン取得が完結します。本セクションでは OBC への予算データ送信までの一連の流れをご紹介します。2026‑07‑01 時点で提供中です。

認証方式の設定とトークン管理

  1. クライアント登録 – OBC 管理コンソールの「API 設定」から client_id と client_secret を取得します。
  2. トークン取得リクエスト（Client Credentials） – 以下のエンドポイントに対して POST し、スコープ budget_write を指定します（公式ドキュメント参照）。

http
POST https://api.obc.jp/oauth2/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&
client_id={CLIENT_ID}&
client_secret={CLIENT_SECRET}&
scope=budget_write

  1. 取得トークンの保管 – 返却された access_token は 1 時間 有効です。Redis 等のインメモリキャッシュに保存し、残存時間が 5 分未満になったら自動再取得するロジックを実装してください。

ポイント：Client Credentials フローはユーザー介在が不要なため、バックエンドジョブで安全に運用できます。

データ取込フローとマッピング例

Loglass 項目 OBC API フィールド 補足
budget_year fiscalYear 文字列 "2024"
department_code deptCode 最大 10 桁の文字列
account_item_id accItemId 整数
planned_amount planAmount 小数点以下 2 桁まで（例: 7500000.00）
actual_amount actualAmount 同上

サンプル JSON（実績データ送信）

POST エンドポイント例

セキュリティベストプラクティス

  • IP アドレス制限 – OBC 管理画面で「許可 IP」設定を行い、社内サーバの固定 IP のみからアクセス可能にします。
  • TLS 1.2+ 強制使用 – 全通信は HTTPS（TLS1.2 以上）で暗号化し、可能なら証明書ピンニングも実装してください。
  • シークレットローテーション – client_secret は最低 90 日 ごとに更新し、古いシークレットは即座に無効化する運用手順を策定します。

ポイント：上記対策を組み合わせることで、認証情報漏洩リスクを大幅に低減できます（参考：OBC セキュリティガイドライン 2026‑04）。

連携完了後の検証ポイントとレポート作成例

API 連携が正しく稼働しているかは、定期的なテストと可視化で確認します。本節では 接続テスト項目 と 月次レポートテンプレート を提示します。

接続テスト項目と結果確認

項目 確認方法 合格基準
認証トークン取得可否 スクリプトで /oauth2/token エンドポイントを叩く 200 OK & 有効期限 > 30 分
データ送信成功率 1,000 件サンプルデータのバッチ実行 成功件数 ≥ 99.5 %
金額整合性（予算 vs 実績） Loglass と会計ツールで同月総額を比較 差異 ≤ ±0.01 %
エラーログ有無 ログファイル・監視ダッシュボードを確認 重大エラー 0 件

テストは CI/CD パイプラインに組み込むと、デプロイ時に自動で検証が走ります。

定期レポートのテンプレート

【月次 API 連携ステータス】

項目 今月実績 前月比較 コメント
実行バッチ回数 30 回 ±0 回 計画通り
成功率（%） 99.8 % -0.1 % 小規模リトライ発生
合計予算金額（円） 120,000,000 同上 変化なし
合計実績金額（円） 118,450,321 +2,300,000 予算超過分は別途処理

分析ポイント

  • 成功率が 99.5 % 未満 の場合はリトライロジックや呼び出し上限（429）を再検討。
  • 金額差異が ±0.01 % を超えるときは、四捨五入・単位変換設定を見直す。

ポイント：レポートは経理部門・IT 部門に共有し、改善サイクルを毎月回すことで運用品質が向上します。

よくある質問（FAQ）とトラブルシューティング

本章では、実装時に頻出する認証エラーやデータ不整合の原因と対策をまとめました。

認証エラーの原因と対策

質問 主な原因 推奨解決策
「401 Unauthorized が返ってきます」 トークン期限切れ、スコープ不足、client_id/secret の記載ミス リフレッシュロジックを実装、スコープ accounting（freee）・budget_write（OBC）を付与
「OAuth 認可コードが取得できません」 登録したリダイレクト URL と実際の URL が不一致 デベロッパーポータルで正確な redirect_uri を設定し直す
「Client Credentials でトークンが取れない」 IP アドレス制限、シークレット誤り OBC 管理画面でサーバ IP を許可リストに追加、シークレットを再発行

データ不整合が起きた時の確認ポイント

  1. 最新マッピング表の使用 – freee・OBC のフィールド定義は随時更新されるため、公式ドキュメントのバージョン情報を必ずチェック。
  2. 数値フォーマット統一 – 金額は 整数（円） または 小数点以下 2 桁 に統一し、通貨単位の違いが混在しないようにする。
  3. タイムゾーンの取り扱い – 日付項目は API が UTC を前提とするケースが多いため、ローカル時間への変換を忘れずに実装。

セルフチェックリスト
- [ ] API キー・シークレットが最新か
- [ ] トークン有効期限と自動リフレッシュ設定
- [ ] マッピング表のバージョン確認（freee v1.0、OBC 2026‑07）
- [ ] ログに 4xx/5xx が出ていないか

上記を順に確認すれば、多くの認証・データエラーは自己解決できます。どうしても解消できない場合は、Loglass カスタマーサポート に以下情報を添えて問い合わせてください。

  • エラーログ（タイムスタンプ・ステータスコード）
  • 実行したリクエスト URL とヘッダー（認証情報はマスク）
  • 使用している API バージョンとスコープ一覧

参考リンク・資料

項目 URL
Loglass 開発者ポータル https://developers.loglass.com/
freee API ドキュメント（2026‑06‑30 更新） https://developer.freee.co.jp/docs/api/v1
OBC API ガイドライン（2026‑04‑15 更新） https://api.obc.jp/documentation
Loglass 利用規約・呼び出し上限 https://developers.loglass.com/terms

本稿の数値・日付は 2026 年 7 月 15 日現在の公式情報に基づいています。変更があった場合は各ベンダーの最新ドキュメントをご確認ください。

スポンサードリンク

-Loglass