Solución de problemas
Lista de comprobación
Casi todos los hilos de soporte empiezan igual: el flujo está abierto y no llega nada. Varias causas distintas se ven idénticas desde fuera. Recorre esta lista.
| Comprobación | Cómo | Si es el caso |
|---|---|---|
¿El socket se cierra con 4001 nada más abrirse? | Lee el motivo del cierre y luego llama a GET /v1/account con la misma clave | missing_api_key: la clave nunca llegó; envíala como Authorization: Bearer, X-API-Key o ?api_key=. invalid_api_key: error tipográfico o secreto rotado. key_revoked: pregunta a quien la emitió |
¿Tu clave tiene stream? | GET /v1/account | Sin él, el socket se cierra con 4003 de inmediato |
| ¿De verdad estás monitorizando a alguien? | GET /v1/monitor/targets | Una lista vacía significa un socket abierto que nunca hablará |
| ¿Ya está activa la entrega en tiempo real para esa cuenta? | La misma llamada — mira push_ready | false justo después de añadirla es normal; la activación suele tardar unos minutos. Mientras tanto, los eventos de la cuenta se entregan completos, aunque algunos pueden llegar más tarde de lo habitual, así que procésalos según lleguen en lugar de esperar a true. Si sigue en false al cabo de una hora, avísanos |
| ¿Limitaste tú o nosotros los tipos de evento? | GET /v1/monitor/targets/{target}, campo event_types; luego GET /v1/account, campo event_types | Vacío significa todos los tipos. La lista de una suscripción es tuya: amplíala con PATCH /v1/monitor/targets/{target}. La lista de toda la clave se configuró a petición tuya; pídenos ampliarla |
| ¿Esperas coincidencias de palabras clave? | GET /v1/keywords, y comprueba que keywords:read está en la clave | Sin el ámbito, search.match se filtra antes de llegar a ti |
| ¿La cuenta está callada, o invisible? | GET /v1/users/{name}/tweets | X oculta algunas cuentas de la búsqueda y de las cronologías de otros. Si no podemos verla, no podemos informar de ella |
| ¿Demasiadas conexiones? | Código de cierre 4002 | Se alcanzó el max_conns de tu plan; un proceso caído puede seguir manteniendo abiertos sockets viejos |
| ¿Añadiste el objetivo después de abrir el socket? | Espera 30 segundos | Una conexión abierta recoge las suscripciones nuevas en su siguiente refresco, no al instante |
¿Recibes 429 en REST? | Lee X-RateLimit-Remaining y Retry-After | Un bucle de solicitudes apretado contra REST es la causa habitual; el flujo no se contabiliza, úsalo en su lugar |
Si sigues atascado: envíanos cualquier X-Request-Id, o el id de un evento que esperabas y no recibiste.