📡 Site oficial do Requests (Documentação)
| # | Comando / Função / Parâmetro | O que faz | Exemplo |
|---|---|---|---|
| 1 | requests.get() | Envia uma requisição GET | requests.get(url) |
| 2 | requests.post() | Envia uma requisição POST | requests.post(url, data=payload) |
| 3 | requests.put() | Envia uma requisição PUT | requests.put(url, data={'k':'v'}) |
| 4 | requests.delete() | Envia uma requisição DELETE | requests.delete(url) |
| 5 | requests.head() | Envia uma requisição HEAD (apenas cabeçalhos) | requests.head(url) |
| 6 | requests.patch() | Envia uma requisição PATCH | requests.patch(url, data={'k':'v'}) |
| 7 | requests.options() | Envia uma requisição OPTIONS | requests.options(url) |
| 8 | requests.request() | Método genérico para qualquer verbo HTTP | requests.request('GET', url) |
| 9 | response.status_code | Retorna o código de status HTTP | if r.status_code == 200: |
| 10 | response.text | Conteúdo da resposta em string (decodificado) | print(r.text) |
| 11 | response.content | Conteúdo da resposta em bytes | with open('img.png', 'wb') as f: f.write(r.content) |
| 12 | response.json() | Decodifica conteúdo JSON para dicionário Python | data = r.json() |
| 13 | response.headers | Dicionário com os cabeçalhos da resposta | r.headers['Content-Type'] |
| 14 | response.url | A URL final da requisição (após redirecionamentos) | print(r.url) |
| 15 | response.encoding | Codificação usada para decodificar .text | r.encoding = 'utf-8' |
| 16 | response.ok | True se status_code for entre 200 e 299 | if r.ok: print("Sucesso") |
| 17 | response.history | Lista de respostas de redirecionamento anteriores | print(r.history) |
| 18 | response.cookies | Cookies enviados pelo servidor | val = r.cookies['sessao_id'] |
| 19 | response.elapsed | Tempo decorrido entre o envio e a resposta | print(r.elapsed.total_seconds()) |
| 20 | response.raise_for_status() | Levanta exceção se houver erro HTTP (4xx ou 5xx) | r.raise_for_status() |
| 21 | params= | Dicionário de parâmetros para a query string (?k=v) | requests.get(url, params={'id': 1}) |
| 22 | data= | Dicionário/corpo para formulários (form-encoded) | requests.post(url, data={'user': 'a'}) |
| 23 | json= | Serializa automaticamente um dict para JSON no corpo | requests.post(url, json={'id': 123}) |
| 24 | headers= | Dicionário de cabeçalhos customizados | requests.get(url, headers={'User-Agent': 'my-app'}) |
| 25 | files= | Dicionário para upload de arquivos | requests.post(url, files={'file': open('a.txt', 'rb')}) |
| 26 | auth= | Tupla para Autenticação Básica (user, pass) | requests.get(url, auth=('user', 'pass')) |
| 27 | timeout= | Tempo limite em segundos para a requisição | requests.get(url, timeout=5) |
| 28 | allow_redirects= | Habilita ou desabilita redirecionamentos automáticos | requests.get(url, allow_redirects=False) |
| 29 | proxies= | Dicionário de configurações de proxy (HTTP/HTTPS) | requests.get(url, proxies={'http': '...'}) |
| 30 | stream=True | Mantém a conexão aberta para baixar grandes arquivos | requests.get(url, stream=True) |
| 31 | verify= | Verifica ou ignora certificados SSL (True/False) | requests.get(url, verify=False) |
| 32 | requests.Session() | Cria um objeto de sessão (persiste cookies) | s = requests.Session() |
| 33 | session.get() | Realiza GET usando os cookies da sessão | s.get(url) |
| 34 | session.headers.update() | Define cabeçalhos padrão para toda a sessão | s.headers.update({'token': 'xyz'}) |
| 35 | session.auth | Define autenticação padrão para a sessão | s.auth = ('user', 'pass') |
| 36 | session.close() | Fecha a sessão e libera conexões | s.close() |
| 37 | requests.utils.dict_from_cookiejar() | Converte jar de cookies para dicionário | dict_cookies = requests.utils.dict_from_cookiejar(r.cookies) |
| 38 | requests.cookies.RequestsCookieJar() | Cria um novo container de cookies manual | jar = requests.cookies.RequestsCookieJar() |
| 39 | requests.exceptions.RequestException | Classe base para todas as exceções do Requests | except requests.exceptions.RequestException: |
| 40 | requests.exceptions.HTTPError | Erro lançado por raise_for_status() | except requests.exceptions.HTTPError: |
| 41 | requests.exceptions.ConnectionError | Erro de DNS ou falha na conexão | except requests.exceptions.ConnectionError: |
| 42 | requests.exceptions.Timeout | Erro quando a requisição excede o tempo limite | except requests.exceptions.Timeout: |
| 43 | HTTPBasicAuth | Objeto para autenticação básica explícita | from requests.auth import HTTPBasicAuth |
| 44 | HTTPDigestAuth | Objeto para autenticação Digest | from requests.auth import HTTPDigestAuth |
| 45 | requests.utils.quote() | Codifica caracteres especiais para URL | requests.utils.quote('foo bar') |
| 46 | requests.codes.ok | Referência simbólica para status 200 | if r.status_code == requests.codes.ok: |
| 47 | requests.codes.not_found | Referência simbólica para status 404 | if r.status_code == requests.codes.not_found: |