Solução de problemas
Lista de verificação
Quase todo chamado de suporte começa do mesmo jeito: o stream está aberto e nada chega. Várias causas diferentes parecem idênticas vistas de fora. Percorra esta lista.
| Verificação | Como | Se for isso |
|---|---|---|
O socket fecha com 4001 logo após abrir? | Leia o motivo do fechamento e depois chame GET /v1/account com a mesma chave | missing_api_key: a chave nunca chegou; envie-a como Authorization: Bearer, X-API-Key ou ?api_key=. invalid_api_key: erro de digitação ou segredo rotacionado. key_revoked: fale com quem a emitiu |
Sua chave tem stream? | GET /v1/account | Sem ele, o socket fecha com 4003 imediatamente |
| Você está realmente monitorando alguém? | GET /v1/monitor/targets | Uma lista vazia significa um socket aberto que nunca vai falar |
| A entrega em tempo real já está ativa para essa conta? | Mesma chamada — veja push_ready | false logo após adicionar é normal; a ativação costuma levar alguns minutos. Enquanto isso, os eventos da conta são entregues completos, embora alguns possam chegar mais tarde que o normal, então trate-os à medida que chegam em vez de esperar por true. Se continuar false depois de uma hora, avise-nos |
| Foi você ou fomos nós que limitamos os tipos de evento? | GET /v1/monitor/targets/{target}, campo event_types; depois GET /v1/account, campo event_types | Vazio significa todos os tipos. A lista de uma assinatura é sua: amplie-a com PATCH /v1/monitor/targets/{target}. A lista da chave inteira foi definida a seu pedido; peça-nos para ampliá-la |
| Esperando correspondências de palavra-chave? | GET /v1/keywords, e confira se keywords:read está na chave | Sem o escopo, search.match é filtrado antes de chegar até você |
| A conta está quieta, ou invisível? | GET /v1/users/{name}/tweets | O X oculta algumas contas da busca e das linhas do tempo de outros. Se não conseguimos vê-la, não conseguimos reportá-la |
| Conexões demais? | Código de fechamento 4002 | O max_conns do seu plano foi atingido; sockets antigos podem ainda estar abertos em um processo que travou |
| Adicionou a conta depois de abrir o socket? | Espere 30 segundos | Uma conexão aberta capta novas assinaturas na próxima atualização, não instantaneamente |
Recebendo 429 na REST? | Leia X-RateLimit-Remaining e Retry-After | Um loop de requisições apertado contra a REST é a causa habitual; o stream não é medido, use-o em vez disso |
Ainda travado: envie-nos qualquer X-Request-Id, ou o id de um evento que você esperava e não recebeu.