Frihet REST API

請求書、顧客、費用、製品、見積もりへのプログラムによるアクセス。スケーラブルな連携のために設計されています。

https://api.frihet.io/v1 v1 — 2026-03-18

開発者向けに作られています

部分更新 PATCH

必要なフィールドのみを更新。Zodで検証された部分スキーマが整合性を保証します。

検索とフィルター

?q=パラメータによる全文検索。正確な結果のためのリソースごとのフィールドマッピング。

バッチ操作

1つのリクエストで最大50のリソースを作成。HTTP 207マルチステータス応答。

べき等性キー

Idempotency-Keyヘッダーを使用してリクエストを安全に再試行。24時間TTL、Firestoreによるサポート。

レート制限ヘッダー

各応答にX-RateLimit-Limit、Remaining、Reset。それに応じて計画してください。

OpenAPI 3.1仕様

機械可読な仕様が /openapi.yaml にあります。16パス、18スキーマ。SDKを自動生成します。

インテリジェンスエンドポイント

/context、/monthly、/quarterly経由でビジネスコンテキスト、月次概要、四半期税務データ。

VeriFactuの安全な削除

ドラフトではない請求書および見積もりのソフトデリート。スペインの税務コンプライアンスのための完全なトレーサビリティ。

エンドポイント

Method	Path	Description
GET	/v1/invoices	請求書を一覧表示
POST	/v1/invoices	請求書を作成
PATCH	/v1/invoices/:id	請求書を更新
DELETE	/v1/invoices/:id	請求書を削除
POST	/v1/invoices/batch	バッチで請求書を作成
GET	/v1/clients	顧客を一覧表示
POST	/v1/clients	顧客を作成
GET	/v1/expenses	費用を一覧表示
POST	/v1/expenses	費用を作成
GET	/v1/products	製品を一覧表示
GET	/v1/quotes	見積もりを一覧表示
GET	/v1/context	ビジネスコンテキスト
GET	/v1/monthly	月次概要
GET	/v1/quarterly	四半期税金
GET	/openapi.yaml	OpenAPI仕様

コード例

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

認証

Frihetパネルの「設定 > API」からAPIキーを生成します。AuthorizationヘッダーにBearerトークンとしてキーを含めてください。

Authorization: Bearer fri_...

APIの完全なドキュメント MCP Server

今日から連携を開始

すべてのプランにAPIアクセスが含まれています。APIキーは「設定」で準備されています。

無料で始める