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

# HTTP ステータスコード

> レスポンスとともに返される HTTP コード。

エラーは [標準の HTTP ステータスコード](https://tools.ietf.org/html/rfc2616#section-10) で返されます。

ステータスコードは次のとおりです:

<ul class="custom-bullets">
  <li>1xx: Informational - 転送プロトコルレベルの情報を通知します。</li>
  <li>2xx: Success - リクエストが成功しました。</li>
  <li>3xx: Redirection - リクエストを完了するために、クライアントは追加のアクションを実行する必要があります。</li>
  <li>4xx: Client Error - クライアントエラーによるリクエスト失敗。</li>
  <li>5xx: Server Error - サーバーエラーによるリクエスト失敗。</li>
</ul>

### 200 Success

リクエストが成功しました。

### 400 Bad Request

`400 Bad Request` エラーは、サーバーがリクエストを処理できなかったことを意味します。このエラーの最も一般的な原因は、リクエスト URL または本文の構文が正しくないことです。

### 401 Unauthorized

`401 Unauthorized` エラーは通常、API 呼び出しのリクエストヘッダーの問題によって引き起こされます。つまり、API 呼び出しに有効な API キーを使用しませんでした。

### 403 Access Denied

アプリケーションが API キーを使用して API 呼び出しを行い、リクエストが許可されない場合。
403 は、[User Profile が一時停止されている](/multiple-users/manage-user-profiles#reactivate-a-suspended-user-profile) 場合にも返されることがあります。

### 404 Resource Not Found

このエラーは、アプリケーションが存在しない API を呼び出そうとしたり、エンティティを取得しようとしたときに発生します。

### 405 Method Not Allowed

このエラーは、リクエスト内の HTTP プロトコルメソッドがサポートされていないことを示します。サポートされているメソッドについては、API のドキュメントを確認してください。

### 429 Rate Limit

#### User Profile レート制限

各 User Profile には、5 分間あたり 300 API リクエストのレート制限があります。レート制限の使用状況は、レスポンスヘッダーを通じて監視できます:

<ul class="custom-bullets">
  <li>`x-ratelimit-max`: 5 分間あたりの最大許可リクエスト数を表示します</li>

  <li>
    `x-ratelimit-count`: 現在の 5 分間で行ったリクエスト数を表示します
  </li>
</ul>

<Info>
  429 エラーコードの応答を確認することをお勧めします。429 エラーが表示された場合、レート制限に達しています。レート制限を超えようとする繰り返しの試みは、User Profile の一時停止につながる可能性があります。

  複数のユーザープロファイルに対する [レート制限の処理](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/) について詳しく学びます。
</Info>

#### Platform Analytics レート制限

ソーシャルネットワークが特定のアカウントに対するアナリティクス呼び出しをスロットリングした場合にも、HTTP `429` が返される可能性があります。これは Ayrshare User Profile の制限とは独立しています。この場合、レスポンスにはプラットフォーム固有の Ayrshare エラーコードが含まれます（たとえば、Facebook Page 別アナリティクススロットルの場合は [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit)）。`code` フィールドを確認して、プロファイルのレート制限とプラットフォーム側のスロットルを区別し、ユーザーに再接続を促す代わりにバックオフして再試行してください。

#### User Profile 削除レート制限

1 秒あたり 8 個のユーザープロファイルを削除できます。バルク削除が必要な場合は、API 呼び出しをずらしてください。

#### レート制限保護と一時停止ポリシー

システムの整合性を保護するため、User Profile がレート制限を頻繁に超過した場合、自動的に一時停止する仕組みを実装しています。
仕組みは次のとおりです:

API リクエストを行う際は、5 分間のウィンドウを慎重に管理する必要があります。
たとえば、1 分間に 300 リクエストを行った場合、追加のリクエストを行うにはさらに 4 分待つ必要があります。
この待機期間中のリクエストは、`429` エラー応答をトリガーします。

User Profile が 24 時間以内に 1,000 件のレート制限違反（429 エラー）を蓄積した場合、そのプロファイルは自動的に一時停止されます。
5 分間の待機期間が終了すると、5 分間あたり 300 という標準制限までリクエストを再開できます。

### 500 Internal Server Error

`500 Internal Server Error` は、Ayrshare で内部エラーが発生しているか、処理が失敗したことを示します。