Skip to content

Commit

Permalink
Moji: Update translations
Browse files Browse the repository at this point in the history
  • Loading branch information
boxmoji committed Aug 5, 2024
1 parent bac8bbc commit b10d729
Show file tree
Hide file tree
Showing 19 changed files with 149 additions and 149 deletions.
38 changes: 19 additions & 19 deletions guides/api-calls/permissions-and-errors/versioning-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,27 +23,27 @@ Boxでは、特定のAPIエンドポイントに対してバージョン管理

APIのバージョン管理により、Boxは、自社のプラットフォームを継続的に強化できると同時に、機能の更新や廃止のための信頼できる手段をサードパーティの開発者に提供することもできます。

To stay informed about the API modifications, monitor the [Changelog](https://developer.box.com/changelog/) and maintain a current email address in the **App Info** section of the Developer Console.
APIの変更について常に最新情報を把握できるように、[変更ログ](https://developer.box.com/changelog/)を注視し、開発者コンソールの \[**アプリ情報**] セクションで現在のメールアドレスを指定しておいてください。

## Error examples
## エラーの例

When using versioned API calls, you can encounter versioning-related errors. This reference lists the most common cases when errors appear and provides you with examples of such errors.
バージョン管理されているAPIコールの使用時に、バージョン管理に関連したエラーが発生する場合があります。このリファレンスでは、エラーが表示される最も一般的なケースを挙げ、そのようなエラーの例を示します。

## Calling with incorrect `box-version` header
## 正しくない`box-version`ヘッダーを使用した呼び出し

If you call an API using an incorrect `box-version` header, the API will respond with an `HTTP error code 400 - Bad Request` error and provide the supported versions in the response message.
正しくない`box-version`ヘッダーを使用してAPIを呼び出すと、APIは`HTTP error code 400 - Bad Request`エラーで応答し、レスポンスのメッセージ内にサポート対象のバージョンを示します。

The response will include one of the following status messages in `message` field:
レスポンスの`message`フィールドには、以下のステータスメッセージのいずれかが含まれます。

| 詳細 | メッセージ |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `box-version` value is an unsupported API version or was sent malformed. | `Invalid API version specified in 'box-version' header.` |
| The request headers did not include `box-version` header when versioned only endpoint was called. | `Missing required box-version header.` |
| `box-version` is empty. | `Invalid (empty) API version specified in 'box-version' header.` |
| `box-version` contained multiple version. It requires **only one** version per request. | `The 'box-version' header supports only one header value per request, do not use comas.` |
| An unsupported API version is used for an existing endpoint. | `Unsupported API version specified in 'box-version' header.` |
| 詳細 | メッセージ |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| `box-version`値が、サポートされていないAPIバージョンであるか、正しくない形式で送信されました。 | `Invalid API version specified in 'box-version' header.` |
| バージョン管理されているエンドポイントのみが呼び出されたときに、リクエストヘッダーに`box-version`ヘッダーが含まれていませんでした。 | `Missing required box-version header.` |
| `box-version`が空です。 | `Invalid (empty) API version specified in 'box-version' header.` |
| `box-version`に複数のバージョンが含まれていました。リクエストごとに指定できるバージョンの数は**1つのみ**です。 | `The 'box-version' header supports only one header value per request, do not use comas.` |
| サポートされていないAPIバージョンが既存のエンドポイントに使用されています。 | `Unsupported API version specified in 'box-version' header.` |

An example of a response with an incorrect `box-version` header:
`box-version`ヘッダーが正しくない場合のレスポンスの例:

```json
{
Expand All @@ -59,20 +59,20 @@ An example of a response with an incorrect `box-version` header:

## URLでの正しくないAPIバージョンの呼び出し

Box documentation specifies API URLs. For instance, the Sign Requests endpoints are accessed via: `https://api.box.com/2.0/sign_requests/`. If you mistakenly make a call to an incorrect version, such as `https://api.box.com/3.0/sign_requests/`, the response returns an `HTTP error code 404 - Not Found` error.
Boxのドキュメントでは、APIのURLが示されています。たとえば、署名リクエストのエンドポイントへのアクセスには`https://api.box.com/2.0/sign_requests/`を使用します。誤って`https://api.box.com/3.0/sign_requests/`のような正しくないバージョンを呼び出すと、レスポンスでは`HTTP error code 404 - Not Found`エラーが返されます。

## 非推奨のAPIの呼び出し

When you use an API version that Box has marked as deprecated, the API will respond as usual. Additionally, it will append a `Deprecation` header, stating the deprecation date. For example:
Boxで非推奨としてマークされたAPIバージョンを使用した場合、APIは通常どおり応答します。また、非推奨になった日付を示す`Deprecation`ヘッダーが追加されます。次に例を示します。

```sh
Deprecation: date="Fri, 11 Nov 2023 23:59:59 GMT"
Box-API-Deprecated-Reason: https://developer.box.com/reference/deprecated

```

You should monitor API responses to verify if the `Deprecation` header is present to accordingly plan the transition to a new API version.
APIレスポンスを監視して`Deprecation`ヘッダーが存在するかどうかを確認し、その結果に応じて新しいAPIバージョンへの移行を計画する必要があります。

## Calling a non-existent version
## 存在しないバージョンの呼び出し

If you attempt to use an outdated API version, such as `2023.0` which has reached its end-of-life, the response will return an `HTTP error code 404 - Not Found`. See [Calling an incorrect API version in the URL](#calling-an-incorrect-api-version-in-the-url) for more information.
公式サポートが終了した古いAPIバージョン (`2023.0`など) を使用しようとすると、レスポンスでは`HTTP error code 404 - Not Found`が返されます。詳細については、[URLでの正しくないAPIバージョンの呼び出し](#calling-an-incorrect-api-version-in-the-url)を参照してください。
Loading

0 comments on commit b10d729

Please sign in to comment.