Muitos scripts de analistas começam buscando dados em uma API. Com a biblioteca requests, isso se parece com resp = requests.get(url, params={"page": 2}, timeout=10). A resposta tem um status_code (200 significa OK, 404 não encontrado, 429 muitas requisições e 500 um erro do servidor), e resp.json() devolve o corpo já interpretado.
Estes exercícios não têm acesso à rede, então a célula de configuração define api_get(path, params), que retorna o mesmo tipo de resposta a partir de dados predefinidos. Todo o resto segue o procedimento real:
- Verifique primeiro o status. O corpo de um erro também é JSON, então lê-lo como dados produz resultados estranhos.
- Percorra as páginas de resultados. As APIs retornam os resultados em páginas; continue solicitando até não haver mais.
- Tente novamente com educação. Ao receber 429, espere e tente de novo um número limitado de vezes.
- Transforme os registros aninhados em linhas antes da análise, usando
.get() para os campos que possam estar ausentes.
Saída: (False, {'error': 'not found'}). O corpo do erro é um JSON válido, então sempre verifique o status antes de usá-lo.