Rust API client for openapi

freee API

スタートガイド

freee API開発がはじめての方はfreee API スタートガイドを参照してください。

仕様

APIエンドポイント

https://api.freee.co.jp/ (httpsのみ)

認証について

OAuth2.0を利用します。詳細はリファレンスの認証に関する記載を参照してください。

データフォーマット

リクエスト、レスポンスともにJSON形式をサポートしていますが、詳細は、API毎の説明欄（application/jsonなど）を確認してください。

後方互換性ありの変更

freeeでは、APIを改善していくために以下のような変更は後方互換性ありとして通知なく変更を入れることがあります。アプリケーション実装者は以下を踏まえて開発を行ってください。

新しいAPIリソース・エンドポイントの追加
既存のAPIに対して必須ではない新しいリクエストパラメータの追加
既存のAPIレスポンスに対する新しいプロパティの追加
既存のAPIレスポンスに対するプロパティの順番の入れ変え
keyとなっているidやcodeの長さの変更（長くする）

共通レスポンスヘッダー

すべてのAPIのレスポンスには以下のHTTPヘッダーが含まれます。

X-Freee-Request-ID
- 各リクエスト毎に発行されるID

共通エラーレスポンス

ステータスコードはレスポンス内のJSONに含まれる他、HTTPヘッダにも含まれる
一部のエラーレスポンスにはエラーコードが含まれます。
詳細は、HTTPステータスコード400台エラー時のチェックポイントを参照してください

type

status : HTTPステータスコードの説明
validation : エラーの詳細の説明（開発者向け）

レスポンスの例

  {
    "status_code" : 400,
    "errors" : [
      {
        "type" : "status",
        "messages" : ["不正なリクエストです。"]
      },
      {
        "type" : "validation",
        "messages" : ["Date は不正な日付フォーマットです。入力例：2019-12-17"]
      }
    ]
  }

API使用制限

freeeは一定期間に過度のアクセスを検知した場合、APIアクセスをコントロールする場合があります。

その際のhttp status codeは403となります。制限がかかってから10分程度が過ぎると再度使用することができるようになります。

/reportsと/receipts/{id}/downloadエンドポイント

freeeはエンドポイント毎に一定頻度以上のアクセスを検知した場合、APIアクセスをコントロールする場合があります。その際のhttp status codeは429（too many requests）となります。

/reports:1秒に10回まで
/receipts/{id}/download:1秒に3回まで

http status codeが429となった場合、API使用ステータスはレスポンスヘッダに付与されます。

x-ratelimit-limit:10
x-ratelimit-remaining:1
x-ratelimit-reset:2023-01-13T10:22:29+09:00

各ヘッダの意味は次のとおりです。

ヘッダ名	説明
x-ratelimit-limit	使用回数の上限
x-ratelimit-remaining	残り使用回数
x-ratelimit-reset	使用回数がリセットされる時刻

プラン別のAPI Rate Limit

freee会計プラン名	事業所とアプリケーション毎に1日でのAPIコール数
エンタープライズ	10,000
プロフェッショナル	5,000
ベーシック	3,000
ミニマム	3,000
上記以外	3,000

Webhookについて

詳細は会計Webhook概要を参照してください。

連絡先

ご不明点、ご要望等は freee サポートデスクへのお問い合わせフォームからご連絡ください。

Overview

This API client was generated by the OpenAPI Generator project. By using the openapi-spec from a remote server, you can easily generate an API client.

API version: v1.0
Package version: v1.0
Build package: org.openapitools.codegen.languages.RustClientCodegen

Installation

Put the package under your project folder in a directory named openapi and add the following to Cargo.toml under [dependencies]:

openapi = { path = "./openapi" }

Documentation for API Endpoints

All URIs are relative to https://api.freee.co.jp

Class | Method | HTTP request | Description ------------ | ------------- | ------------- | ------------- AccountItemsApi | createaccountitem | POST /api/1/accountitems | 勘定科目の作成 *AccountItemsApi* | destroyaccountitem | DELETE /api/1/accountitems/{id} | 勘定科目の削除 AccountItemsApi | getaccountitem | GET /api/1/accountitems/{id} | 勘定科目の取得 *AccountItemsApi* | getaccountitems | GET /api/1/accountitems | 勘定科目一覧の取得 AccountItemsApi | updateaccountitem | PUT /api/1/accountitems/{id} | 勘定科目の更新 *ApprovalFlowRoutesApi* | getapprovalflowroute | GET /api/1/approvalflowroutes/{id} | 申請経路の取得 ApprovalFlowRoutesApi | getapprovalflowroutes | GET /api/1/approvalflowroutes | 申請経路一覧の取得 *ApprovalRequestsApi* | createapprovalrequest | POST /api/1/approvalrequests | 各種申請の作成 ApprovalRequestsApi | destroyapprovalrequest | DELETE /api/1/approvalrequests/{id} | 各種申請の削除 *ApprovalRequestsApi* | getapprovalrequest | GET /api/1/approvalrequests/{id} | 各種申請の取得 ApprovalRequestsApi | getapprovalrequestform | GET /api/1/approvalrequests/forms/{id} | 各種申請の申請フォームの取得 ApprovalRequestsApi | getapprovalrequestforms | GET /api/1/approvalrequests/forms | 各種申請の申請フォーム一覧の取得 ApprovalRequestsApi | getapprovalrequests | GET /api/1/approvalrequests | 各種申請一覧の取得 *ApprovalRequestsApi* | updateapprovalrequest | PUT /api/1/approvalrequests/{id} | 各種申請の更新 ApprovalRequestsApi | updateapprovalrequestaction | POST /api/1/approvalrequests/{id}/actions | 各種申請の承認操作 BanksApi | getbank | GET /api/1/banks/{id} | 連携サービスの取得 *BanksApi* | getbanks | GET /api/1/banks | 連携サービス一覧の取得 CompaniesApi | getcompanies | GET /api/1/companies | 事業所一覧の取得 *CompaniesApi* | getcompany | GET /api/1/companies/{id} | 事業所の取得 DealsApi | createdeal | POST /api/1/deals | 取引（収入・支出）の作成 *DealsApi* | destroydeal | DELETE /api/1/deals/{id} | 取引（収入・支出）の削除 DealsApi | getdeal | GET /api/1/deals/{id} | 取引（収入・支出）の取得 *DealsApi* | getdeals | GET /api/1/deals | 取引（収入・支出）一覧の取得 DealsApi | updatedeal | PUT /api/1/deals/{id} | 取引（収入・支出）の更新 *ExpenseApplicationLineTemplatesApi* | createexpenseapplicationlinetemplate | POST /api/1/expenseapplicationlinetemplates | 経費科目の作成 ExpenseApplicationLineTemplatesApi | destroyexpenseapplicationlinetemplate | DELETE /api/1/expenseapplicationlinetemplates/{id} | 経費科目の削除 *ExpenseApplicationLineTemplatesApi* | getexpenseapplicationlinetemplate | GET /api/1/expenseapplicationlinetemplates/{id} | 経費科目の取得 ExpenseApplicationLineTemplatesApi | getexpenseapplicationlinetemplates | GET /api/1/expenseapplicationlinetemplates | 経費科目一覧の取得 *ExpenseApplicationLineTemplatesApi* | updateexpenseapplicationlinetemplate | PUT /api/1/expenseapplicationlinetemplates/{id} | 経費科目の更新 ExpenseApplicationsApi | createexpenseapplication | POST /api/1/expenseapplications | 経費申請の作成 *ExpenseApplicationsApi* | destroyexpenseapplication | DELETE /api/1/expenseapplications/{id} | 経費申請の削除 ExpenseApplicationsApi | getexpenseapplication | GET /api/1/expenseapplications/{id} | 経費申請詳細の取得 *ExpenseApplicationsApi* | getexpenseapplications | GET /api/1/expenseapplications | 経費申請一覧の取得 ExpenseApplicationsApi | updateexpenseapplication | PUT /api/1/expenseapplications/{id} | 経費申請の更新 *ExpenseApplicationsApi* | updateexpenseapplicationaction | POST /api/1/expenseapplications/{id}/actions | 経費申請の承認操作 *InvoicesApi* | createinvoice | POST /api/1/invoices | 請求書の作成 InvoicesApi | destroyinvoice | DELETE /api/1/invoices/{id} | 請求書の削除 *InvoicesApi* | getinvoice | GET /api/1/invoices/{id} | 請求書の取得 InvoicesApi | getinvoices | GET /api/1/invoices | 請求書一覧の取得 *InvoicesApi* | updateinvoice | PUT /api/1/invoices/{id} | 請求書の更新 ItemsApi | createitem | POST /api/1/items | 品目の作成 *ItemsApi* | destroyitem | DELETE /api/1/items/{id} | 品目の削除 ItemsApi | getitem | GET /api/1/items/{id} | 品目の取得 *ItemsApi* | getitems | GET /api/1/items | 品目一覧の取得 ItemsApi | updateitem | PUT /api/1/items/{id} | 品目の更新 *JournalsApi* | downloadjournal | GET /api/1/journals/reports/{id}/download | 仕訳帳のダウンロード JournalsApi | getjournalstatus | GET /api/1/journals/reports/{id}/status | 仕訳帳のステータスの取得 JournalsApi | getjournals | GET /api/1/journals | 仕訳帳のダウンロード要求 *ManualJournalsApi* | createmanualjournal | POST /api/1/manualjournals | 振替伝票の作成 ManualJournalsApi | destroymanualjournal | DELETE /api/1/manualjournals/{id} | 振替伝票の削除 *ManualJournalsApi* | getmanualjournal | GET /api/1/manualjournals/{id} | 振替伝票の取得 ManualJournalsApi | getmanualjournals | GET /api/1/manualjournals | 振替伝票一覧の取得 *ManualJournalsApi* | updatemanualjournal | PUT /api/1/manualjournals/{id} | 振替伝票の更新 PartnersApi | createpartner | POST /api/1/partners | 取引先の作成 *PartnersApi* | destroypartner | DELETE /api/1/partners/{id} | 取引先の削除 PartnersApi | getpartner | GET /api/1/partners/{id} | 取引先の取得 *PartnersApi* | getpartners | GET /api/1/partners | 取引先一覧の取得 PartnersApi | updatepartner | PUT /api/1/partners/{id} | 取引先の更新 *PartnersApi* | updatepartnerbycode | PUT /api/1/partners/code/{code} | 取引先の更新 PaymentRequestsApi | createpaymentrequest | POST /api/1/paymentrequests | 支払依頼の作成 *PaymentRequestsApi* | destroypaymentrequest | DELETE /api/1/paymentrequests/{id} | 支払依頼の削除 PaymentRequestsApi | getpaymentrequest | GET /api/1/paymentrequests/{id} | 支払依頼の取得 *PaymentRequestsApi* | getpaymentrequests | GET /api/1/paymentrequests | 支払依頼一覧の取得 PaymentRequestsApi | updatepaymentrequest | PUT /api/1/paymentrequests/{id} | 支払依頼の更新 *PaymentRequestsApi* | updatepaymentrequestaction | POST /api/1/paymentrequests/{id}/actions | 支払依頼の承認操作 *PaymentsApi* | createdealpayment | POST /api/1/deals/{id}/payments | 取引（収入・支出）の支払行の作成 *PaymentsApi* | destroydealpayment | DELETE /api/1/deals/{id}/payments/{paymentid} | 取引（収入・支出）の支払行の削除 PaymentsApi | updatedealpayment | PUT /api/1/deals/{id}/payments/{paymentid} | 取引（収入・支出）の支払行の更新 *QuotationsApi* | createquotation | POST /api/1/quotations | 見積書の作成 QuotationsApi | destroyquotation | DELETE /api/1/quotations/{id} | 見積書の削除 *QuotationsApi* | getquotation | GET /api/1/quotations/{id} | 見積書の取得 QuotationsApi | getquotations | GET /api/1/quotations | 見積書一覧の取得 *QuotationsApi* | updatequotation | PUT /api/1/quotations/{id} | 見積書の更新 ReceiptsApi | createreceipt | POST /api/1/receipts | ファイルボックス（証憑ファイル）のアップロード *ReceiptsApi* | destroyreceipt | DELETE /api/1/receipts/{id} | ファイルボックス（証憑ファイル）の削除 ReceiptsApi | downloadreceipt | GET /api/1/receipts/{id}/download | ファイルボックス（証憑ファイル）のダウンロード *ReceiptsApi* | getreceipt | GET /api/1/receipts/{id} | ファイルボックス（証憑ファイル）の取得 ReceiptsApi | getreceipts | GET /api/1/receipts | ファイルボックス（証憑ファイル）一覧の取得 *ReceiptsApi* | updatereceipt | PUT /api/1/receipts/{id} | ファイルボックス（証憑ファイル）の更新 RenewsApi | createdealrenew | POST /api/1/deals/{id}/renews | 取引（収入・支出）の+更新の作成 RenewsApi | deletedealrenew | DELETE /api/1/deals/{id}/renews/{renewid} | 取引（収入・支出）の+更新の削除 *RenewsApi* | updatedealrenew | PUT /api/1/deals/{id}/renews/{renewid} | 取引（収入・支出）の+更新の更新 SectionsApi | createsection | POST /api/1/sections | 部門の作成 *SectionsApi* | destroysection | DELETE /api/1/sections/{id} | 部門の削除 SectionsApi | getsection | GET /api/1/sections/{id} | 部門の取得 *SectionsApi* | getsections | GET /api/1/sections | 部門一覧の取得 SectionsApi | updatesection | PUT /api/1/sections/{id} | 部門の更新 *SegmentTagsApi* | createsegmenttag | POST /api/1/segments/{segmentid}/tags | セグメントタグの作成 SegmentTagsApi | destroysegmentstag | DELETE /api/1/segments/{segmentid}/tags/{id} | セグメントタグの削除 *SegmentTagsApi* | getsegmenttags | GET /api/1/segments/{segmentid}/tags | セグメントタグ一覧の取得 SegmentTagsApi | updatesegmenttag | PUT /api/1/segments/{segmentid}/tags/{id} | セグメントタグの更新 *SelectablesApi* | getformsselectables | GET /api/1/forms/selectables | フォーム用選択項目情報の取得 *TagsApi* | createtag | POST /api/1/tags | メモタグの作成 TagsApi | destroytag | DELETE /api/1/tags/{id} | メモタグの削除 *TagsApi* | gettag | GET /api/1/tags/{id} | メモタグの取得 TagsApi | gettags | GET /api/1/tags | メモタグ一覧の取得 *TagsApi* | updatetag | PUT /api/1/tags/{id} | メモタグの更新 TaxesApi | gettaxcode | GET /api/1/taxes/codes/{code} | 税区分の取得 TaxesApi | gettaxcodes | GET /api/1/taxes/codes | 税区分一覧の取得 TaxesApi | gettaxescompanies | GET /api/1/taxes/companies/{companyid} | 指定した事業所の税区分一覧の取得 *TransfersApi* | createtransfer | POST /api/1/transfers | 取引（振替）の作成 TransfersApi | destroytransfer | DELETE /api/1/transfers/{id} | 取引（振替）の削除 *TransfersApi* | gettransfer | GET /api/1/transfers/{id} | 取引（振替）の取得 TransfersApi | gettransfers | GET /api/1/transfers | 取引（振替）一覧の取得 *TransfersApi* | updatetransfer | PUT /api/1/transfers/{id} | 取引（振替）の更新 TrialBalanceApi | gettrialbs | GET /api/1/reports/trialbs | 貸借対照表の取得 *TrialBalanceApi* | gettrialbsthreeyears | GET /api/1/reports/trialbsthreeyears | 貸借対照表(３期間比較)の取得 TrialBalanceApi | gettrialbstwoyears | GET /api/1/reports/trialbstwoyears | 貸借対照表(前年比較)の取得 *TrialBalanceApi* | gettrialcr | GET /api/1/reports/trialcr | 製造原価報告書の取得 TrialBalanceApi | gettrialcrsections | GET /api/1/reports/trialcrsections | 製造原価報告書(部門比較)の取得 *TrialBalanceApi* | gettrialcrsegment1tags | GET /api/1/reports/trialcrsegment1tags | 製造原価報告書(セグメント1比較)の取得 *TrialBalanceApi* | gettrialcrsegment2tags | GET /api/1/reports/trialcrsegment2tags | 製造原価報告書(セグメント2比較)の取得 *TrialBalanceApi* | gettrialcrsegment3tags | GET /api/1/reports/trialcrsegment3tags | 製造原価報告書(セグメント3比較)の取得 *TrialBalanceApi* | gettrialcrthreeyears | GET /api/1/reports/trialcrthreeyears | 製造原価報告書(３期間比較)の取得 TrialBalanceApi | gettrialcrtwoyears | GET /api/1/reports/trialcrtwoyears | 製造原価報告書(前年比較)の取得 *TrialBalanceApi* | gettrialpl | GET /api/1/reports/trialpl | 損益計算書の取得 TrialBalanceApi | gettrialplsections | GET /api/1/reports/trialplsections | 損益計算書(部門比較)の取得 *TrialBalanceApi* | gettrialplsegment1tags | GET /api/1/reports/trialplsegment1tags | 損益計算書(セグメント1比較)の取得 *TrialBalanceApi* | gettrialplsegment2tags | GET /api/1/reports/trialplsegment2tags | 損益計算書(セグメント2比較)の取得 *TrialBalanceApi* | gettrialplsegment3tags | GET /api/1/reports/trialplsegment3tags | 損益計算書(セグメント3比較)の取得 *TrialBalanceApi* | gettrialplthreeyears | GET /api/1/reports/trialplthreeyears | 損益計算書(３期間比較)の取得 TrialBalanceApi | gettrialpltwoyears | GET /api/1/reports/trialpltwoyears | 損益計算書(前年比較)の取得 *UsersApi* | getusers | GET /api/1/users | 事業所に所属するユーザー一覧の取得 UsersApi | getuserscapabilities | GET /api/1/users/capabilities | ログインユーザーの権限の取得 UsersApi | getusersme | GET /api/1/users/me | ログインユーザーの取得 UsersApi | updateuser | PUT /api/1/users/me | ログインユーザーの更新 *WalletTxnsApi* | createwallettxn | POST /api/1/wallettxns | 口座明細の作成 WalletTxnsApi | destroywallettxn | DELETE /api/1/wallettxns/{id} | 口座明細の削除 *WalletTxnsApi* | getwallettxn | GET /api/1/wallettxns/{id} | 口座明細の取得 WalletTxnsApi | getwallettxns | GET /api/1/wallettxns | 口座明細一覧の取得 *WalletablesApi* | createwalletable | POST /api/1/walletables | 口座の作成 WalletablesApi | destroywalletable | DELETE /api/1/walletables/{type}/{id} | 口座の削除 *WalletablesApi* | getwalletable | GET /api/1/walletables/{type}/{id} | 口座の取得 WalletablesApi | getwalletables | GET /api/1/walletables | 口座一覧の取得 *WalletablesApi* | updatewalletable | PUT /api/1/walletables/{type}/{id} | 口座の更新

Documentation For Models

To get access to the crate's generated documentation, use:

cargo doc --open