문제 해결
체크리스트
거의 모든 지원 스레드는 같은 방식으로 시작합니다. 스트림은 열려 있는데 아무것도 오지 않는다는 것입니다. 서로 다른 여러 원인이 밖에서 보면 똑같아 보입니다. 이 목록을 차례로 확인하십시오.
| 확인 | 방법 | 해당된다면 |
|---|---|---|
열리자마자 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를 기다리지 말고 오는 대로 처리하세요. 한 시간이 지나도 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를 보내주십시오.