Preskočiť na obsah

Kontakty

Ľudia a firmy, s ktorými pracujete.

Otvoriť Kontakty
Overené voči nástenke dňa 20. novembra 2026

Kontakty nemajú vlastnú mikroslužbu. Ich verejné metódy patria mikroslužbe účtu, ktorá obsahuje aj Profily, a mikroslužbe tímu pre žiadosti o priateľstvo. Každá koná za účet, ktorého API kľúč použijete.

Skupiny, štítky, vlastné polia, Ostaňte v kontakte, kontrola duplikátov, import a výber plánu dnes nemajú verejnú metódu. Robia sa v dashboarde.

Pošlite požiadavku metóde so svojím kľúčom:

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',
    },
)

Odmietnutá požiadavka odpovie záporným code a dôvod uvedie v data. Väčšina metód nižšie berie aj voliteľné workspace_id, aby konala v pracovnom priestore, ktorý vlastníte, inom než vo vašom domovskom.

Čítanie kontaktov

get_contacts vypíše kontakty.

  • _id alebo contact_id vráti jeden kontakt.
  • search filtruje zoznam podľa vyhľadávacieho reťazca a name podľa mena.
  • filter_type zužuje zoznam, napríklad na archived, shared, pinned, favorites alebo online. Ak sa vynechá, vypíše aktívne kontakty spolu s čakajúcimi žiadosťami o spojenie.
  • with_requests nastavené na true pridá čakajúce žiadosti, odoslané aj prijaté, aj do filtrovaného zoznamu.
  • tag vypíše kontakty, ktoré nesú jeden štítok, folder_id vypíše jeden priečinok (pošlite __none__ pre kontakty bez priečinka) a group_id vypíše členov jednej skupiny kontaktov.
  • profile_id číta kontakty iného vášho profilu. limit, skip a bookmark stránkujú zoznam.

Pridanie kontaktu

create_contact pridá osobu ručne. Berie name a email, ktoré sú povinné, a voliteľne phone, company, job_title a account_type nastavené na personal alebo business, čo modelu ušetrí hádanie.

  • E-mail je kľúč adresára. Odoslanie e-mailu, ktorý už máte, vráti existujúci kontakt namiesto druhej kópie.
  • source zaznamenáva, odkiaľ kontakt pochádza, manual, keď nepošlete nič, a context je jeden riadok, ktorý sa zobrazí v aktivite kontaktu.
  • profile_id zaradí kontakt pod iný váš profil.
  • Nikoho sa nič nepýta a neodosiela sa žiadny e-mail. Je to to isté ako Pridať bez pozvánky v dashboarde.

Ak chcete priniesť zoznam z kódu, zavolajte ju raz pre každú osobu.

Žiadosti o priateľstvo

  • add_contact_member odošle žiadosť inému používateľovi Xuda, nájdenému podľa access_email alebo podľa to_uid.
  • get_contact_members vypíše vaše žiadosti a spojenia, každé s kartou druhej osoby. stat berie jeden stav žiadosti, alebo niekoľko, na vypísanie.
  • unfriend_contact berie contact_id a ukončí spojenie. Kontakt zostane vo vašom adresári.

Organizovanie kontaktu

Každá z nich berie contact_id.

Archivácia a odstránenie

Odstránenie sa nedá vrátiť späť

Kontakt odstránený cez delete_contact je preč. Archivácia je krok, ktorý použite, keď chcete kontakt len dať z cesty.

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026