- 1xx: Informational - 転送プロトコルレベルの情報を通知します。
- 2xx: Success - リクエストが成功しました。
- 3xx: Redirection - リクエストを完了するために、クライアントは追加のアクションを実行する必要があります。
- 4xx: Client Error - クライアントエラーによるリクエスト失敗。
- 5xx: Server Error - サーバーエラーによるリクエスト失敗。
200 Success
リクエストが成功しました。400 Bad Request
400 Bad Request エラーは、サーバーがリクエストを処理できなかったことを意味します。このエラーの最も一般的な原因は、リクエスト URL または本文の構文が正しくないことです。
401 Unauthorized
401 Unauthorized エラーは通常、API 呼び出しのリクエストヘッダーの問題によって引き起こされます。つまり、API 呼び出しに有効な API キーを使用しませんでした。
403 Access Denied
アプリケーションが API キーを使用して API 呼び出しを行い、リクエストが許可されない場合。 403 は、User Profile が一時停止されている 場合にも返されることがあります。404 Resource Not Found
このエラーは、アプリケーションが存在しない API を呼び出そうとしたり、エンティティを取得しようとしたときに発生します。405 Method Not Allowed
このエラーは、リクエスト内の HTTP プロトコルメソッドがサポートされていないことを示します。サポートされているメソッドについては、API のドキュメントを確認してください。429 Rate Limit
User Profile レート制限
各 User Profile には、5 分間あたり 300 API リクエストのレート制限があります。レート制限の使用状況は、レスポンスヘッダーを通じて監視できます:x-ratelimit-max: 5 分間あたりの最大許可リクエスト数を表示しますx-ratelimit-count: 現在の 5 分間で行ったリクエスト数を表示します
429 エラーコードの応答を確認することをお勧めします。429 エラーが表示された場合、レート制限に達しています。レート制限を超えようとする繰り返しの試みは、User Profile の一時停止につながる可能性があります。複数のユーザープロファイルに対する レート制限の処理 について詳しく学びます。
Platform Analytics レート制限
ソーシャルネットワークが特定のアカウントに対するアナリティクス呼び出しをスロットリングした場合にも、HTTP429 が返される可能性があります。これは Ayrshare User Profile の制限とは独立しています。この場合、レスポンスにはプラットフォーム固有の Ayrshare エラーコードが含まれます（たとえば、Facebook Page 別アナリティクススロットルの場合は code: 444）。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 で内部エラーが発生しているか、処理が失敗したことを示します。