トラブルシューティング
チェックリスト
サポートへの問い合わせのほとんどは同じ状況から始まります。ストリームは開いているのに何も届かない、というものです。外から見ると同じでも、原因はいくつもあります。このリストを上から順に確認してください。
| 確認事項 | 確認方法 | 該当する場合 |
|---|---|---|
開いた直後に 4001 で閉じますか? | クローズ理由を読み、同じキーで GET /v1/account を呼ぶ | missing_api_key:キーが届いていません。Authorization: Bearer、X-API-Key、?api_key= のいずれかで送ってください。invalid_api_key:入力ミスかローテーション済みのシークレット。key_revoked:発行者に確認してください |
キーに stream がありますか? | GET /v1/account | なければソケットは即座に 4003 で閉じます |
| 実際に誰かを監視していますか? | GET /v1/monitor/targets | 一覧が空なら、開いたソケットは永遠に何も話しません |
| そのアカウントのリアルタイム配信はもう有効ですか? | 同じ呼び出しで push_ready を確認 | 追加直後に false なのは正常で、通常は数分で有効になります。その間もアカウントのイベントは漏れなく配信されますが、一部は通常より遅れて届くことがあるため、true を待たずに届いたものから処理してください。1 時間たっても false のままならご連絡ください |
| イベント種類を絞ったのはあなたか、私たちか? | GET /v1/monitor/targets/{target} の event_types、次に GET /v1/account の event_types | 空はすべての種類です。購読のリストはあなたのもので、PATCH /v1/monitor/targets/{target} で広げられます。キー全体のリストはご依頼で設定したものなので、広げるにはご連絡ください |
| キーワードのヒットを期待していますか? | GET /v1/keywords と、キーに keywords:read があるかを確認 | スコープがなければ、search.match は届く前に除外されます |
| アカウントが静かなだけか、見えないのか? | GET /v1/users/{name}/tweets | X は一部のアカウントを検索や他人のタイムラインから隠します。当社に見えないものは報告できません |
| 接続が多すぎますか? | クローズコード 4002 | プランの max_conns に達しています。クラッシュしたプロセスが古いソケットを保持したままかもしれません |
| ソケットを開いた後に監視対象を追加しましたか? | 30 秒待つ | 開いている接続は次回の更新時に新しい購読を拾います。即時ではありません |
REST で 429 が出ますか? | X-RateLimit-Remaining と Retry-After を読む | REST に対する短い間隔のリクエストループがよくある原因です。ストリームは従量課金ではないので、そちらを使ってください |
それでも解決しない場合: X-Request-Id か、届くはずだったのに届かなかったイベントの id をお送りください。