del_post

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

刪除文章。

參數:

• board (str) -- 看板名稱。

• aid (str) -- 文章編號。

• index (int) -- 文章編號。

• reason (str) -- 板主刪除他人文章時，加註於刪除後標題的理由（僅板主刪除他板友文章時有效）。

• bad_post_type (data_type.BadPostType) -- 板主刪除他人文章時，對作者記的惡退（劣文）分類， 僅板主刪除他板友文章時有效。

• bad_post_reason (str) -- 惡退理由，僅 bad_post_type 為 BadPostType.OTHER 時可傳入且必須傳入， 長度上限 50 字。

回傳:

None

引發:

• RequireLogin -- 需要登入。

• UnregisteredUser -- 未註冊使用者。

• NoSuchBoard -- 看板不存在。

• NoSuchPost -- 文章不存在。

• NoPermission -- 沒有權限。

• ParameterError -- 對自己的文章傳入 reason 或 bad_post_type（僅適用於版主刪除他人文章）， 或 bad_post_type 為 BadPostType.OTHER 卻未傳入 bad_post_reason（或超過 50 bytes， 或含有控制字元）。

• BadPostNotRecorded -- 傳入 bad_post_type 時，文章已成功刪除，但 PTT 端沒有完成惡退 （劣文）記錄流程（例如文章太舊而跳過惡退選單、或逾時）。代表刪除本身已經成功， 只是這支惡退沒有記上。

範例:

import PyPtt

ptt_bot = PyPtt.API()
try:
    # .. login ..
    ptt_bot.del_post(board='Python', aid='1TJH_XY0')
    # 板主刪除他人文章，並記一支「廣告」惡退
    ptt_bot.del_post(board='Python', aid='1TJH_XY0',
                      bad_post_type=PyPtt.BadPostType.AD)
    # .. do something ..
finally:
    ptt_bot.logout()