get_mail

PyPtt.API.get_mail(self, index: int, search_type: SearchType | None = None, search_condition: str | None = None, search_list: list | None = None) → Dict

取得信件。

參數:

• index (int) -- 信件編號。

• search_type (SearchType) -- 搜尋類型。

• search_condition -- 搜尋條件。

• search_list -- 搜尋清單。

回傳:

Dict，信件資訊，詳見 MailField。

引發:

• RequireLogin -- 需要登入。

• NoSuchMail -- 信件不存在。

• NoPermission -- 沒有權限。

範例:

import PyPtt

ptt_bot = PyPtt.API()
try:
    # .. login ..
    mail = ptt_bot.get_mail(index=1)
    # .. do something ..
finally:
    ptt_bot.logout()

以作者搜尋信件（先用 get_newest_index 取得該作者的信件數，再逐封取得）:

import PyPtt

ptt_bot = PyPtt.API()

search_list = [(PyPtt.SearchType.AUTHOR, 'CodingMan')]

try:
    # .. login ..
    count = ptt_bot.get_newest_index(PyPtt.NewIndex.MAIL, search_list=search_list)
    mail = ptt_bot.get_mail(index=count, search_list=search_list)
    # .. do something ..
finally:
    ptt_bot.logout()

參考 get_newest_index