Fehlerbehebung
Checkliste
Fast jeder Support-Thread beginnt gleich: Der Stream ist offen, und nichts kommt an. Mehrere verschiedene Ursachen sehen von außen identisch aus. Arbeiten Sie diese Liste ab.
| Prüfung | Wie | Wenn es das ist |
|---|---|---|
Schließt der Socket direkt nach dem Öffnen mit 4001? | Schließgrund lesen, dann GET /v1/account mit demselben Schlüssel aufrufen | missing_api_key: Der Schlüssel kam nie an; senden Sie ihn als Authorization: Bearer, X-API-Key oder ?api_key=. invalid_api_key: Tippfehler oder rotiertes Secret. key_revoked: Fragen Sie den Aussteller |
Hat Ihr Schlüssel stream? | GET /v1/account | Ohne sie schließt der Socket sofort mit 4003 |
| Überwachen Sie überhaupt jemanden? | GET /v1/monitor/targets | Eine leere Liste bedeutet einen offenen Socket, der nie sprechen wird |
| Ist die Echtzeit-Zustellung für dieses Konto schon aktiv? | Derselbe Aufruf – sehen Sie auf push_ready | false direkt nach dem Hinzufügen ist normal; die Aktivierung dauert meist einige Minuten. Die Ereignisse des Kontos werden in der Zwischenzeit vollständig zugestellt, manche aber eventuell später als üblich; verarbeiten Sie sie also, sobald sie eintreffen, statt auf true zu warten. Bleibt es eine Stunde lang false, sagen Sie uns Bescheid |
| Haben Sie oder wir die Ereignistypen eingeschränkt? | GET /v1/monitor/targets/{target}, Feld event_types; dann GET /v1/account, Feld event_types | Leer heißt alle Typen. Die Liste eines Abonnements gehört Ihnen: erweitern Sie sie mit PATCH /v1/monitor/targets/{target}. Die schlüsselweite Liste wurde auf Ihren Wunsch gesetzt; bitten Sie uns, sie zu erweitern |
| Erwarten Sie Stichwort-Treffer? | GET /v1/keywords, und prüfen Sie, ob keywords:read auf dem Schlüssel ist | Ohne die Berechtigung wird search.match herausgefiltert, bevor es Sie erreicht |
| Ist das Konto still oder unsichtbar? | GET /v1/users/{name}/tweets | X verbirgt manche Konten vor der Suche und vor den Timelines anderer. Was wir nicht sehen können, können wir nicht melden |
| Zu viele Verbindungen? | Close-Code 4002 | Das max_conns Ihres Tarifs ist erreicht; alte Sockets werden womöglich noch von einem abgestürzten Prozess offen gehalten |
| Das Ziel nach dem Öffnen des Sockets hinzugefügt? | 30 Sekunden warten | Eine offene Verbindung übernimmt neue Abonnements bei ihrer nächsten Aktualisierung, nicht sofort |
Bekommen Sie 429 bei REST? | Lesen Sie X-RateLimit-Remaining und Retry-After | Eine enge Anfrageschleife gegen REST ist die übliche Ursache; der Stream wird nicht gezählt, nutzen Sie stattdessen ihn |
Immer noch festgefahren: Senden Sie uns eine beliebige X-Request-Id oder die id eines Ereignisses, das Sie erwartet und nicht erhalten haben.