del_post¶

PyPtt.API.del_post(self, board: str, aid: str | None = None, index: int = 0, reason: str | None = None) → None

刪除文章。

參數:

board (str) -- 看板名稱。
aid (str) -- 文章編號。
index (int) -- 文章編號。
reason (str) -- 板主刪除他人文章時，加註於刪除後標題的理由（僅板主刪除他板友文章時有效）。

回傳:

None

引發:

RequireLogin -- 需要登入。
UnregisteredUser -- 未註冊使用者。
NoSuchBoard -- 看板不存在。
NoSuchPost -- 文章不存在。
NoPermission -- 沒有權限。
ParameterError -- 對自己的文章傳入 reason（加註理由僅適用於版主刪除他人文章）。

範例:

import PyPtt

ptt_bot = PyPtt.API()
try:
    # .. login ..
    ptt_bot.del_post(board='Python', aid='1TJH_XY0')
    # .. do something ..
finally:
    ptt_bot.logout()