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

# ベースURLとバージョン管理

# ベースURL、バージョン管理、エンドポイントの構成

Sorsa APIはURLにバージョンを含めることで、連携の安定性を維持しています。バージョン番号はベースURLの一部であり、すべてのリクエストは特定のAPIバージョンを明示的に指定します。

## ベースURL

すべてのリクエストはHTTPSで送信します。通常のHTTPには対応しておらず、リクエストは拒否されます。

```text theme={null}
https://api.sorsa.io/v3
```

各エンドポイントのパスは、このベースURLを基準にしています。例えば、ユーザープロフィールを取得する完全なURLは次のとおりです。

```text theme={null}
https://api.sorsa.io/v3/info?username=elonmusk
```

## 現在のバージョン：v3

`v3` は、Sorsa APIの現在の安定版であり、推奨バージョンです。新しいエンドポイント、レスポンスフィールド、改善はすべてv3で提供されます。

## 変更のバージョン管理

すべての更新で新しいバージョン番号が必要になるわけではありません。変更は2種類に分かれます。

### 後方互換性のある変更（v3内で提供）

以下の変更は、バージョン番号を上げずに現行バージョンに追加されます。既存の連携は、利用者側で変更することなく動作し続けます。

* 新しいエンドポイントの追加
* 既存のエンドポイントへの任意のクエリパラメータの追加
* JSONレスポンスオブジェクトへの新しいフィールドの追加
* エラーメッセージの改善やエラーレスポンスへの詳細情報の追加

レスポンスフィールドは随時追加される可能性があります。未知のフィールドが現れてもエラーにせず、必要なフィールドを読み取り、認識できないキーは無視するようにレスポンスを処理してください。

### 互換性を損なう変更（新しいバージョン番号）

レスポンスフィールドの削除、パラメータ名の変更、認証方式の変更、エンドポイントの基本動作の変更が必要になった場合は、新しいバージョン（例えば `/v4`）を公開します。その際は、次の対応を行います。

* 終了までの移行期間を明確に案内し、その間は旧バージョンを稼働させます
* フィールドの対応関係と構造上の変更を記載した移行ガイドを事前に公開します
* 廃止までの日程をダッシュボードとドキュメントで案内します

## 旧バージョン：v2（提供終了）

v2は廃止され、すでに停止しています。予定されていた停止日は**2026年5月1日**で、現在v2のエンドポイントは `410 Gone` を返します。

既存のSorsa v2連携を移行する場合は、現在の[APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide)でv3のリクエストとレスポンスのスキーマを確認し、移行支援が必要なら[サポートにお問い合わせください](https://docs.sorsa.io/ja/support)。別途用意されている公式X APIからの移行ガイドは、Sorsa v2とは異なるAPIを対象としています。

## 次のステップ

* [認証](https://docs.sorsa.io/ja/authentication) — v3リクエストを認証する方法
* [サポート](https://docs.sorsa.io/ja/support) — 既存のSorsa v2連携の移行支援
* [APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide) — すべてのエンドポイントのパラメータとレスポンススキーマ