core

The all-in-one capsule: session, request, response

https://docs.aiohttp.org/en/stable/client_reference.html#client-session


source

request

 request (method:str, url:str, headers:Optional[dict]=None,
          params:Optional[dict]=None, data:Union[dict,str,NoneType]=None,
          json:Optional[dict]=None, proxy:Optional[str]=None,
          auth:Optional[aiohttp.helpers.BasicAuth]=None, text:bool=False)

Asynchronously send a HTTP request with a new session and return the response.

text

text is a boolean flag denoting whether response should be returned as a string or json (dict).

await request('GET', 'https://api.coingecko.com/api/v3/ping', text=False)
{'gecko_says': '(V3) To the Moon!'}
await request('GET', 'https://example.com/', text=True)
'<!doctype html>\n<html>\n<head>\n    <title>Example Domain</title>\n\n    <meta charset="utf-8" />\n    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />\n    <meta name="viewport" content="width=device-width, initial-scale=1" />\n    <style type="text/css">\n    body {\n        background-color: #f0f0f2;\n        margin: 0;\n        padding: 0;\n        font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI", "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;\n        \n    }\n    div {\n        width: 600px;\n        margin: 5em auto;\n        padding: 2em;\n        background-color: #fdfdff;\n        border-radius: 0.5em;\n        box-shadow: 2px 3px 7px 2px rgba(0,0,0,0.02);\n    }\n    a:link, a:visited {\n        color: #38488f;\n        text-decoration: none;\n    }\n    @media (max-width: 700px) {\n        div {\n            margin: 0 auto;\n            width: auto;\n        }\n    }\n    </style>    \n</head>\n\n<body>\n<div>\n    <h1>Example Domain</h1>\n    <p>This domain is for use in illustrative examples in documents. You may use this\n    domain in literature without prior coordination or asking for permission.</p>\n    <p><a href="https://www.iana.org/domains/example">More information...</a></p>\n</div>\n</body>\n</html>\n'