> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめに

> Cleariflowの銀行検証APIは、モダンなRESTful JSONインターフェースを通じて国際銀行口座番号（IBAN）とビジネス識別コード（BIC）の包括的な検証を提供し、50か国以上をサポートします。

## はじめに

<Card title="IBAN検証" icon="credit-card" href="bank-validation/iban">
  `iban`エンドポイントは、国別の包括的な検証、フォーマットチェック、金融アプリケーション向けの詳細な構造情報を備えた国際銀行口座番号（IBAN）を検証します。
</Card>

<Card title="BIC検証" icon="building" href="bank-validation/bic">
  `bic`エンドポイントはビジネス識別コード（BIC）を検証し、国際銀行業務向けに銀行コード、国情報、機関タイプの詳細な内訳を提供します。
</Card>

<Card title="サポート対象国" icon="globe" href="bank-validation/countries">
  IBANおよびBIC検証のサポート対象国の包括的なリスト。国コード、通貨情報、フォーマット要件を含みます。
</Card>

### RESTアーキテクチャ

銀行検証APIはRESTの原則に従い、予測可能なリソース指向のURLと標準的なHTTPステータスコードを使用して、シームレスな統合とエラーハンドリングを実現します。

### HTTPSセキュリティ

すべてのAPI通信はTLS 1.2以上の暗号化プロトコルで保護され、データの完全性とプライバシーが確保されます。

### APIバージョン管理

銀行検証APIはバージョン管理により後方互換性を維持しており、現在はバージョン1で稼働し、将来の機能強化が計画されています。

### 認証

APIキーは銀行検証APIにアクセスするための唯一の認証情報です。Cleariflowの各サービスには固有のキーが必要であり、異なるAPI間で安全かつ分離されたアクセスが保証されます。

## レスポンスおよびエラーコード

リクエストが失敗した場合、APIは効果的なトラブルシューティングのために、特定のコードと説明を含む構造化されたJSONエラーレスポンスを返します。

| Code | Type                  | Details                                                          |
| ---- | --------------------- | ---------------------------------------------------------------- |
| 200  | OK                    | すべてが想定どおりに動作しました。                                                |
| 400  | Bad request           | 不正なリクエスト — パラメータが欠落しているか無効です。                                    |
| 401  | Unauthorized          | リクエストが受け付けられませんでした。通常はAPIキーが欠落しているか不正です。                         |
| 422  | Quota reached         | APIクレジット不足のためリクエストが中止されました。（無料プラン）                               |
| 429  | Too many requests     | 許可された秒あたりのリクエスト数に達したためリクエストが中止されました。無料プランでは1秒あたり1リクエストに制限されています。 |
| 500  | Internal server error | サーバー側のエラーによりリクエストを完了できませんでした。                                    |
| 503  | Service unavailable   | サーバーが利用できませんでした。                                                 |
