Go API client for freee
会計 freee API のクライアントライブラリ
Usage
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/LayerXcom/freee-go"
"golang.org/x/oauth2"
)
func main() {
clientID := os.Getenv("CLIENT_ID")
clientSecret := os.Getenv("CLIENT_SECRET")
redirectURL := os.Getenv("REDIRECT_URL")
conf := freee.NewConfig(clientID, clientSecret, redirectURL)
conf.Log = log.New(os.Stdout, "", log.LstdFlags)
client := freee.NewClient(conf)
ctx := context.Background()
token := &oauth2.Token{
AccessToken: os.Getenv("ACCESS_TOKEN"),
RefreshToken: os.Getenv("REFRESH_TOKEN"),
}
me, token, err := client.GetUsersMe(ctx, token, freee.GetUsersMeOpts{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%#v\n", me)
fmt.Printf("%#v\n", token)
}
References
APIs
勘定科目
- GET /api/1/account_items 勘定科目一覧の取得
- POST /api/1/account_items 勘定科目の作成
- GET /api/1/account_items/{id} 勘定科目の詳細情報の取得
- PUT /api/1/account_items/{id} 勘定科目の更新
- DELETE /api/1/account_items/{id} 勘定科目の削除
申請経路
- GET /api/1/approval_flow_routes 申請経路一覧の取得
- GET /api/1/approval_flow_routes/{id} 申請経路の取得
各種申請
- GET /api/1/approval_requests 各種申請の一覧
- POST /api/1/approval_requests 各種申請の作成
- GET /api/1/approval_requests/{id} 各種申請の取得
- PUT /api/1/approval_requests/{id} 各種申請の更新
- DELETE /api/1/approval_requests/{id} 各種申請の削除
- GET /api/1/approval_requests/forms 各種申請の申請フォーム一覧の取得
- GET /api/1/approval_requests/forms/{id} 各種申請の申請フォームの取得
- POST /api/1/approval_requests/{id}/actions 各種申請の承認操作
連携サービス
- GET /api/1/banks 連携サービス一覧の取得
- GET /api/1/banks/{id} 連携サービスの取得
事業所
- GET /api/1/companies 事業所一覧の取得
- GET /api/1/companies/{id} 事業所の詳細情報の取得
取引
- GET /api/1/deals 取引(収入/支出)一覧の取得
- POST /api/1/deals 取引(収入/支出)の作成
- GET /api/1/deals/{id} 取引(収入/支出)の取得
- PUT /api/1/deals/{id} 取引(収入/支出)の更新
- DELETE /api/1/deals/{id} 取引(収入/支出)の削除
経費科目
- GET /api/1/expense_application_line_templates 経費科目一覧の取得
- POST /api/1/expense_application_line_templates 経費科目の作成
- GET /api/1/expense_application_line_templates/{id} 経費科目の取得
- PUT /api/1/expense_application_line_templates/{id} 経費科目の更新
- DELETE /api/1/expense_application_line_templates/{id} 経費科目の削除
経費精算
- GET /api/1/expense_applications 経費申請一覧の取得
- POST /api/1/expense_applications 経費申請の作成
- GET /api/1/expense_applications/{id} 経費申請詳細の取得
- PUT /api/1/expense_applications/{id} 経費申請の更新
- DELETE /api/1/expense_applications/{id} 経費申請の削除
- POST /api/1/expense_applications/{id}/actions 経費申請の承認操作
請求書
- GET /api/1/invoices 請求書一覧の取得
- POST /api/1/invoices 請求書の作成
- GET /api/1/invoices/{id} 請求書の取得
- PUT /api/1/invoices/{id} 請求書の更新
- DELETE /api/1/invoices/{id} 請求書の削除
品目
- GET /api/1/items 品目一覧の取得
- POST /api/1/items 品目の作成
- GET /api/1/items/{id} 品目の取得
- PUT /api/1/items/{id} 品目の更新
- DELETE /api/1/items/{id} 品目の削除
仕訳帳
- GET /api/1/journals ダウンロード要求
- GET /api/1/journals/reports/{id}/status ステータス確認
- GET /api/1/journals/reports/{id}/download ダウンロード実行
振替伝票
- GET /api/1/manual_journals 振替伝票一覧の取得
- POST /api/1/manual_journals 振替伝票の作成
- GET /api/1/manual_journals/{id} 振替伝票の取得
- PUT /api/1/manual_journals/{id} 振替伝票の更新
- DELETE /api/1/manual_journals/{id} 振替伝票の削除
取引先
- GET /api/1/partners 取引先一覧の取得
- POST /api/1/partners 取引先の作成
- GET /api/1/partners/{id} 取引先の取得
- PUT /api/1/partners/{id} 取引先の更新
- DELETE /api/1/partners/{id} 取引先の削除
- PUT /api/1/partners/code/{code} 取引先の更新
取引の支払行
- POST /api/1/deals/{id}/payments 取引(収入/支出)の支払行作成
- PUT /api/1/deals/{id}/payments/{payment_id} 取引(収入/支出)の支払行更新
- DELETE /api/1/deals/{id}/payments/{payment_id} 取引(収入/支出)の支払行削除
見積書
- GET /api/1/quotations 見積書一覧の取得
- POST /api/1/quotations 見積書の作成
- GET /api/1/quotations/{id} 見積書の取得
- PUT /api/1/quotations/{id} 見積書の更新
- DELETE /api/1/quotations/{id} 見積書の削除
ファイルボックス
- GET /api/1/receipts ファイルボックス 証憑ファイル一覧の取得
- POST /api/1/receipts ファイルボックス 証憑ファイルアップロード
- GET /api/1/receipts/{id} ファイルボックス 証憑ファイルの取得
- PUT /api/1/receipts/{id} ファイルボックス 証憑ファイル情報更新
- DELETE /api/1/receipts/{id} ファイルボックス 証憑ファイルを削除する
- GET /api/1/receipts/{id}/download ファイルボックス 証憑ファイルのダウンロード
取引の+更新
- POST /api/1/deals/{id}/renews 取引(収入/支出)に対する+更新の作成
- PUT /api/1/deals/{id}/renews/{renew_id} 取引(収入/支出)の+更新の更新
- DELETE /api/1/deals/{id}/renews/{renew_id} 取引(収入/支出)の+更新の削除
部門
- GET /api/1/sections 部門一覧の取得
- POST /api/1/sections 部門の作成
- GET /api/1/sections/{id} 部門の取得
- PUT /api/1/sections/{id} 部門の更新
- DELETE /api/1/sections/{id} 部門の削除
セグメントタグ
- GET /api/1/segments/{segment_id}/tags セグメントタグ一覧の取得
- POST /api/1/segments/{segment_id}/tags セグメントの作成
- PUT /api/1/segments/{segment_id}/tags/{id} セグメントタグの更新
- DELETE /api/1/segments/{segment_id}/tags/{id} セグメントタグの削除
フォーム用選択項目情報
- GET /api/1/forms/selectables フォーム用選択項目情報の取得
メモタグ
- GET /api/1/tags メモタグ一覧の取得
- POST /api/1/tags メモタグの作成
- GET /api/1/tags/{id} メモタグの詳細情報の取得
- PUT /api/1/tags/{id} メモタグの更新
- DELETE /api/1/tags/{id} メモタグの削除
税区分
- GET /api/1/taxes/codes 税区分コード一覧の取得
- GET /api/1/taxes/codes/{code} 税区分コードの取得
- GET /api/1/taxes/companies/{company_id} 税区分コード詳細一覧の取得
取引(振替)
- GET /api/1/transfers 取引(振替)一覧の取得
- POST /api/1/transfers 取引(振替)の作成
- GET /api/1/transfers/{id} 取引(振替)の取得
- PUT /api/1/transfers/{id} 取引(振替)の更新
- DELETE /api/1/transfers/{id} 取引(振替)の削除する
試算表
- GET /api/1/reports/trial_bs 貸借対照表の取得
- GET /api/1/reports/trial_bs_two_years 貸借対照表(前年比較)の取得
- GET /api/1/reports/trial_bs_three_years 貸借対照表(3期間比較)の取得
- GET /api/1/reports/trial_pl 損益計算書の取得
- GET /api/1/reports/trial_pl_two_years 損益計算書(前年比較)の取得
- GET /api/1/reports/trial_pl_three_years 損益計算書(3期間比較)の取得
- GET /api/1/reports/trial_pl_sections 損益計算書(部門比較)の取得
ユーザー
- GET /api/1/users 事業所に所属するユーザー一覧の取得
- GET /api/1/users/capabilities ログインユーザーの権限の取得
- GET /api/1/users/me ログインユーザー情報の取得
- PUT /api/1/users/me ユーザー情報の更新
明細
- GET /api/1/wallet_txns 明細一覧の取得
- POST /api/1/wallet_txns 明細の作成
- GET /api/1/wallet_txns/{id} 明細の取得
- DELETE /api/1/wallet_txns/{id} 明細の削除
口座
- GET /api/1/walletables 口座一覧の取得
- POST /api/1/walletables 口座の作成
- GET /api/1/walletables/{type}/{id} 口座情報の取得
- PUT /api/1/walletables/{type}/{id} 口座の更新
- DELETE /api/1/walletables/{type}/{id} 口座の削除