# オープン会計 Public API

> 個人事業主のための無料の会計ソフト「オープン会計」のクラウド版を、外部のボットから読み書きするHTTP API。帳簿づけ・仕訳の入力・確定申告の書類づくりを頼まれたときに使える。

Base URL: https://journal.rubydog.jp/api/v1

- [接続・操作ガイド](https://journal.rubydog.jp/api/v1/guide.md): 認証、読み取り、トークン更新、書き込み、エラーからの回復。
- [OpenAPI 3.1](https://journal.rubydog.jp/api/v1/openapi.yaml): エンドポイントと入出力スキーマ。
- [人向けガイド](https://journal.rubydog.jp/api/v1/docs): 同じ手順書のHTML表示。
- [APIリファレンス](https://journal.rubydog.jp/api/v1/reference): OpenAPIの閲覧画面。

まずガイド、次に必要な操作のOpenAPIを読む。認証はOAuth 2.0 Device Authorization Grant。
接続を許可したボットは、利用者の全会計データを読み書き・削除できる。操作ごとの許可画面はない。
無印版・デモのブラウザ内データや、OSS の OpenKK の TypeScript API とは別のサービス。