< 可调用对象列表
此部分为机器人的网络请求功能相关。
若需要请求网络,请使用此处的函数或 aiohttp
库,不可使用 requests
库。
def private_ip_check
private_ip_check(url: str)
参数:
-
url
:URL 地址。
异常:
ValueError
:URL 为私有 IP 地址。
此函数可以检查 URL 是否为私有 IP 地址。
async def get_url
get_url(url: str, status_code: int = False, headers: dict = None, params: dict = None, fmt: str = None, timeout: int = 20, attempt: int = 3, request_private_ip: bool = False, logging_err_resp: bool = True, cookies: dict = None)
参数:
-
url
:URL 地址。 -
status_code
:状态码。 -
headers
:请求时的 HTTP 标头。 -
params
:请求时使用的参数。 -
fmt
:请求时使用的参数。 -
timeout
:超时时间。(默认20
) -
attempt
:尝试次数。(默认3
) -
request_private_ip
:是否允许请求私有 IP。(默认False
) -
logging_err_resp
:是否允许日志记录错误响应。(默认False
) -
cookies
:使用的 Cookies。
异常:
ValueError
:状态码与预期不符、无效获取格式、请求超时。
此异步函数可以对 URL 发送 GET 请求,并获取对应内容。
async def post_url
post_url(url: str, data: any = None, status_code: int = False, headers: dict = None, fmt: str = None, timeout: int = 20, attempt: int = 3, request_private_ip: bool = False, logging_err_resp: bool = True, cookies: dict = None)
参数:
-
url
:URL 地址。 data
:需要发送的数据。-
status_code
:状态码。 -
headers
:请求时的 HTTP 标头。 -
params
:请求时使用的参数。 -
fmt
:请求时使用的参数。 -
timeout
:超时时间。(默认20
) -
attempt
:尝试次数。(默认3
) -
request_private_ip
:是否允许请求私有 IP。(默认False
) -
logging_err_resp
:是否允许日志记录错误响应。(默认False
) -
cookies
:使用的 Cookies。
异常:
ValueError
:状态码与预期不符、无效获取格式、请求超时。
此异步函数可以对 URL 发送 POST 请求,并获取对应内容。
async def download
download(url: str, filename: str = None, path: str = None, status_code: int = False, method: str = "GET", post_data: any = None, headers: dict = None, timeout: int = 20, attempt: int = 3, request_private_ip: bool = False, logging_err_resp: bool = True) -> Union[str, bool]
参数:
-
url
:URL 地址。 -
filename
:文件名,默认为随机文件名。 -
path
:下载目录,默认为缓存目录。 -
status_code
:状态码。 -
method
:请求方法(默认GET
)。 post_data
:若请求方法为 POST,需要发送的数据。-
headers
:请求时的 HTTP 标头。 -
timeout
:超时时间。(默认20
) -
attempt
:尝试次数。(默认3
) -
request_private_ip
:是否允许请求私有 IP。(默认False
) -
logging_err_resp
:是否允许日志记录错误响应。(默认False
)
异常:
ValueError
:状态码与预期不符、无效获取格式、请求超时。
返回:文件的相对路径,若获取失败则返回 False
。
此异步函数可以下载 URL 内容,并保存到指定目录。