Siirry sisältöön

Sähköpostit

Omat postilaatikkosi, isännöinti ja lähetysrajat.

Avaa Sähköpostit
Tarkistettu koontinäyttöä vasten 19. marraskuuta 2026

Sähköposteilla on neljätoista julkista metodia. Ne kattavat sivun lukupuolen: mitä postilaatikoita sinulla on, niiden posti, sen luettu- ja arkistoitu-tila, uuden postin haku sekä tekoälyn muistiinpanot päivästä ja luonnoksesta. Kolmetoista niistä toimii sen tilin puolesta, jonka API-avainta käytät. Neljästoista, test_email, vaatii ylläpitäjän avaimen.

Viestin lähetys, postilaatikon lisäys, paketin valinta, Sähköpostin asetukset ja edelleenlähetysosoitteet tehdään kojelaudassa. Niille ei ole nykyisin julkista metodia.

Lähetä pyyntö metodille avaimellasi:

curl -s https://xuda.ai/cpi/get_user_emails \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID","mailbox_name":"inbox","read":false,"limit":25}'
const res = await fetch('https://xuda.ai/cpi/get_user_emails', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
    mailbox_name: 'inbox',
    read: false,
    limit: 25,
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_user_emails',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
        'mailbox_name': 'inbox',
        'read': False,
        'limit': 25,
    },
)

Onnistuneen vastauksen code on 1. data sisältää docs-kentän, eli viestit, bookmark-kentän, jonka palautat seuraavaa sivua varten, ja total_emails-kentän.

Lue posti

  • get_user_mailboxes antaa kunkin postilaatikon viestimäärät.
  • get_user_emails listaa postia. mailbox_name on inbox tai sent tai mikä tahansa muu kansiopolku, jonka on täsmättävä tarkasti. email_account_id rajaa yhteen postilaatikkoon, search hakee aiheesta ja toisen osapuolen nimestä tai osoitteesta, read arvolla false antaa vain lukemattoman postin, ja filter_type arvolla archived listaa arkistoidun postin, joka muuten jätetään pois. date_from ja date_to (epookkimillisekunteina) rajaavat päivämäärät, contact_email antaa yhden osoitteen kanssa vaihdetun postin ja email_id antaa yhden viestin. Sivuta kentillä limit, skip ja bookmark.
  • get_email_overview laskee saapuneen postin päivittäin, oletuksena 14 päivää ja enintään 31, sekä lukemattoman postin postilaatikoittain. Sillä piirretään palkin pisteet.
  • get_email_brief vastaa sillä yhdellä lauseella, jonka tekoäly kirjoittaa tämän päivän postin yhteenvedoista. Se säilytetään päivän ajan ja kirjoitetaan uudelleen vain, kun tämän päivän posti muuttuu. Anna locale ja tz_offset, jos haluat sen lukijan kielellä ja päivälle.

Siivoa se

  • read_email ja unread_email merkitsevät viestin ja sen keskustelukohteen luetuksi tai lukemattomaksi email_id-arvolla. read_email jättää postilaatikon oman nähty-lipun ja viestin ajan ennalleen.
  • archive_email arkistoi viestin. unarchive_email palauttaa arkistoidun viestin tilaan, jossa se oli.

Pidä ajan tasalla

  • refresh_mailboxes hakee uuden postin nyt, kaikille postilaatikoille tai yhdelle, kun annat email_account_id-arvon. Se on sama kuin Päivitä-painike.
  • pause_mailbox_import keskeyttää postilaatikon tuonnin heti, kuten tuonnin Peruuta tekee. Mitään lisää ei lueta eikä lajitella sille, ennen kuin jatkat synkronointia metodilla refresh_mailboxes.
  • process_pending_email saa tekoälyn lukemaan yhden viestin uudelleen. Anna reset_error, jos haluat tyhjentää ensin sen tallentaman virheen, kuten Yritä uudelleen tekee.

Pyydä tekoälyn muistiinpanot luonnoksesta

get_email_read_along lukee luonnoksen kirjoittajan rinnalla eikä kirjoita mitään. Se kertoo, mitä vastattava viesti kysyy ja vastaako luonnos siihen, luonnoksessa mainitun tiedoston, jota ei ole liitetty, ja mainitun ajan, johon kalenteri ei sovi. Anna luonnos pelkkänä tekstinä kentässä draft, vastattava viesti kentässä email_id, liitettyjen tiedostojen nimet kentässä attached sekä kirjoittajan tz_offset, time_zone ja locale. Sitä Lue mukana käyttää.

Katkaise postilaatikon yhteys

delete_email_account katkaisee postilaatikon yhteyden email_account_id-arvolla. Se on sama kuin Katkaise yhteys postilaatikon ikkunassa. Postilaatikko merkitään poistetuksi, ja jo tuotu posti jää työtilaan.

Xuda-postilaatikko poistetaan pysyvästi

Xuda-postilaatikon yhteyden katkaiseminen poistaa sen kaikkine viesteineen postipalvelimelta, eikä sitä voi perua. Gmailin tai Outlookin yhteyden katkaiseminen säilyttää viestit täällä ja ottaa Xudan pääsyn pois. Outlookin kohdalla Xuda poistaa omat tunnisteensa; Xuda pysyy Microsoft-tilin sovelluslistalla, kunnes henkilö poistaa sen siellä.

Metodit

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026