Nordlet

標準ベースの会計処理のための1つのAPI

請求書作成、総勘定元帳、銀行の突合、税務申告をひとつのJSON APIで提供します。アプリ自体も提供される同じエンドポイント上で動作します。

インタラクティブなAPIリファレンスを開くライブの仕様から生成された、すべてのエンドポイント、スキーマ、およびサンプル。

仕組み

予測可能な呼び出しすべての操作は、JSONボディを持つ POST /v1/{module}/{resource}/{action} です。パターンを理解すれば、どのモジュールも同じように機能します。
スコープ付きAPIキーAuthorization: Bearer で認証します。sales:write などのスコープにより、各統合は実際に必要なアクセスに制限されます。
安全なリトライIdempotency-Key ヘッダーを追加すれば、リトライされたリクエストが重複して作成されることはありません。
ウェブフックsale_invoice.paidなどのイベントを購読します。配信はHMAC署名され、バックオフ付きでリトライされるため、ポーリングする必要はありません。
型付きSDKOpenAPI仕様から生成されたTypeScriptクライアント。すべてのエンドポイントのリクエストおよびレスポンスの型が含まれています。
正確な金額金額は浮動小数点数ではなく文字列として処理されるため、帳簿上で1セントの狂いもありません。

最初の呼び出し

curl -X POST https://api.nordlet.com/v1/partners/create \
  -H "Authorization: Bearer nl_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-first-partner" \
  -d '{"name": "UAB Example", "code": "301111222"}'