Siirry sisältöön

Yhteystiedot

Ihmiset ja yritykset, joiden kanssa työskentelet.

Avaa Yhteystiedot
Tarkistettu koontinäyttöä vasten 20. marraskuuta 2026

Yhteystiedoilla ei ole omaa mikropalvelua. Sen julkiset metodit kuuluvat tili-mikropalveluun, jossa ovat myös Profiilit, ja tiimi-mikropalveluun ystäväpyyntöjä varten. Jokainen toimii sen tilin puolesta, jonka API-avainta käytät.

Ryhmät, tunnisteet, omat kentät, Pidä yhteyttä, kaksoiskappaletarkistus, tuonti ja paketin valinta eivät tällä hetkellä ole julkisia metodeja. Ne tehdään kojelaudassa.

Lähetä pyyntö metodille avaimellasi:

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

Evätyn pyynnön code on negatiivinen, ja data kertoo syyn. Useimmat alla olevista metodeista ottavat myös valinnaisen workspace_id-kentän, jolla toimit omistamassasi työtilassa, joka ei ole kotityötilasi.

Lue yhteystietoja

get_contacts listaa yhteystiedot.

  • _id tai contact_id palauttaa yhden yhteystiedon.
  • search suodattaa listaa hakumerkkijonolla ja name nimellä.
  • filter_type rajaa listaa, esimerkiksi arvoihin archived, shared, pinned, favorites tai online. Jos se jätetään pois, se listaa aktiiviset yhteystiedot sekä odottavat yhteyspyynnöt.
  • with_requests arvolla true lisää odottavat pyynnöt, lähetetyt ja vastaanotetut, myös suodatettuun listaan.
  • tag listaa yhteystiedot, joilla on yksi tunniste, folder_id listaa yhden kansion (lähetä __none__ yhteystiedoille, jotka eivät ole missään kansiossa) ja group_id listaa yhden yhteystietoryhmän jäsenet.
  • profile_id lukee toisen profiilisi yhteystiedot. limit, skip ja bookmark sivuttavat listaa.

Lisää yhteystieto

create_contact lisää henkilön käsin. Se ottaa name- ja email-kentät, jotka ovat pakollisia, ja valinnaisesti phone, company, job_title sekä account_type arvolla personal tai business, mikä säästää mallilta arvaamisen vaivan.

  • Sähköposti on kirjan avain. Jo hallussasi olevan lähettäminen palauttaa olemassa olevan yhteystiedon toisen kopion sijaan.
  • source kirjaa, mistä yhteystieto tuli, manual, kun et lähetä mitään, ja context on yksi rivi, joka näkyy yhteystiedon toiminnassa.
  • profile_id arkistoi yhteystiedon toisen profiilisi alle.
  • Ketään ei kysytä miltään eikä sähköpostia lähetetä. Se on sama kuin Lisää ilman kutsua kojelaudassa.

Tuodaksesi listan koodista kutsu sitä kerran henkilöä kohden.

Ystäväpyynnöt

  • add_contact_member lähettää pyynnön toiselle Xuda-käyttäjälle, joka löytyy access_email- tai to_uid-kentällä.
  • get_contact_members listaa pyyntösi ja yhteytesi, kullakin toisen henkilön kortti. stat ottaa yhden pyynnön tilan tai useita listattavaksi.
  • unfriend_contact ottaa contact_id-kentän ja päättää yhteyden. Yhteystieto pysyy kirjassasi.

Järjestä yhteystieto

Jokainen näistä ottaa contact_id-kentän.

Arkistoi ja poista

Poistoa ei voi perua

Yhteystieto, joka poistetaan metodilla delete_contact, on poissa. Arkistointi on askel, jota käytät, kun haluat vain saada yhteystiedon pois tieltä.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026