Přeskočit na obsah

Kontakty

Lidé a firmy, se kterými pracujete.

Otevřít Kontakty
Ověřeno podle nástěnky dne 20. listopadu 2026

Kontakty nemají vlastní mikroslužbu. Jejich veřejné metody patří mikroslužbě account, která drží také Profily, a mikroslužbě team pro žádosti o přátelství. Každá jedná za účet, jehož klíč API použijete.

Skupiny, štítky, vlastní pole, Zůstaňte v kontaktu, kontrola duplicit, import a volba tarifu dnes nemají veřejnou metodu. Ty se dělají v dashboardu.

Pošlete požadavek metodě se svým klíčem:

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

Odmítnutý požadavek odpoví záporným code a v data říká proč. Většina metod níže bere také volitelné workspace_id, aby jednala v jiném pracovním prostoru, který vlastníte, než ve svém domovském.

Čtení kontaktů

get_contacts vypisuje kontakty.

  • _id nebo contact_id vrátí jeden kontakt.
  • search filtruje seznam podle hledaného řetězce a name podle jména.
  • filter_type zužuje seznam, například na archived, shared, pinned, favorites nebo online. Když chybí, vypíše aktivní kontakty spolu s čekajícími žádostmi o spojení.
  • with_requests nastavené na true přidá čekající žádosti, odeslané i přijaté, i do filtrovaného seznamu.
  • tag vypíše kontakty, které nesou jeden štítek, folder_id vypíše jednu složku (pošlete __none__ pro kontakty bez složky) a group_id vypíše členy jedné skupiny kontaktů.
  • profile_id čte kontakty jiného vašeho profilu. limit, skip a bookmark stránkují seznam.

Přidání kontaktu

create_contact přidá člověka ručně. Bere name a email, které jsou povinné, a volitelně phone, company, job_title a account_type nastavené na personal nebo business, což modelu ušetří hádání.

  • E-mail je klíč adresáře. Odeslání toho, který už držíte, vrátí existující kontakt místo druhé kopie.
  • source zaznamenává, odkud kontakt přišel, manual, když žádný nepošlete, a context je jeden řádek, který se zobrazí v aktivitě kontaktu.
  • profile_id zařadí kontakt pod jiný váš profil.
  • Nikdo se na nic neptá a neodchází žádný e-mail. Je to totéž jako Přidat bez pozvánky v dashboardu.

Chcete-li přinést seznam z kódu, zavolejte jej jednou pro každého člověka.

Žádosti o přátelství

  • add_contact_member pošle žádost jinému uživateli Xuda, nalezenému podle access_email nebo to_uid.
  • get_contact_members vypisuje vaše žádosti a spojení, každé s kartou druhého člověka. stat bere jeden stav žádosti, nebo několik, k výpisu.
  • unfriend_contact bere contact_id a ukončí spojení. Kontakt zůstává ve vašem adresáři.

Organizace kontaktu

Každá z nich bere contact_id.

Archivace a smazání

Smazání nelze vrátit zpět

Kontakt smazaný pomocí delete_contact je pryč. Archivace je krok, který použijte, když chcete kontakt jen odklidit.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026