Przejdź do treści

Kontakty

Ludzie i firmy, z którymi pracujesz.

Otwórz Kontakty
Sprawdzono z pulpitem dnia 20 listopada 2026

Kontakty nie mają własnego mikroserwisu. Ich metody publiczne należą do mikroserwisu konta, który mieści też Profile, oraz do mikroserwisu zespołu dla zaproszeń do znajomych. Każda działa dla konta, którego klucza API używasz.

Grupy, tagi, pola niestandardowe, Bądź w kontakcie, sprawdzanie duplikatów, import i wybór planu nie mają dziś metody publicznej. Te rzeczy robi się w dashboardzie.

Wyślij żądanie do metody ze swoim kluczem:

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

Odrzucone żądanie odpowiada ujemnym code i w data mówi dlaczego. Większość poniższych metod przyjmuje też opcjonalne workspace_id, by działać w przestrzeni roboczej, którą posiadasz, innej niż domowa.

Odczyt kontaktów

get_contacts wyświetla kontakty.

  • _id lub contact_id zwraca jeden kontakt.
  • search filtruje listę po ciągu wyszukiwania, a name po nazwie.
  • filter_type zawęża listę, na przykład do archived, shared, pinned, favorites lub online. Pominięte, wyświetla aktywne kontakty razem z oczekującymi zaproszeniami do połączenia.
  • with_requests ustawione na true dodaje do przefiltrowanej listy także oczekujące zaproszenia, wysłane i otrzymane.
  • tag wyświetla kontakty z jednym tagiem, folder_id wyświetla jeden folder (wyślij __none__ dla kontaktów bez folderu), a group_id wyświetla członków jednej grupy kontaktów.
  • profile_id odczytuje kontakty innego Twojego profilu. limit, skip i bookmark stronicują listę.

Dodawanie kontaktu

create_contact dodaje osobę ręcznie. Przyjmuje name i email, które są wymagane, oraz opcjonalnie phone, company, job_title i account_type ustawione na personal lub business, co oszczędza modelowi zgadywania.

  • E-mail jest kluczem książki. Wysłanie takiego, który już masz, zwraca istniejący kontakt zamiast drugiej kopii.
  • source zapisuje, skąd pochodzi kontakt, manual, gdy nic nie wyślesz, a context to jedna linia, która pokazuje się w aktywności kontaktu.
  • profile_id zapisuje kontakt pod innym Twoim profilem.
  • Nikt o nic nie jest pytany i nie jest wysyłany żaden e-mail. To to samo co Dodaj bez zaproszenia w dashboardzie.

Aby wczytać listę z kodu, wywołaj to raz dla każdej osoby.

Zaproszenia do znajomych

  • add_contact_member wysyła zaproszenie do innego użytkownika Xuda, znalezionego przez access_email lub to_uid.
  • get_contact_members wyświetla Twoje zaproszenia i połączenia, każde z kartą drugiej osoby. stat przyjmuje jeden status zaproszenia lub kilka do wyświetlenia.
  • unfriend_contact przyjmuje contact_id i kończy połączenie. Kontakt zostaje w Twojej książce.

Porządkowanie kontaktu

Każda z nich przyjmuje contact_id.

Archiwizowanie i usuwanie

Usunięcia nie można cofnąć

Kontakt usunięty przez delete_contact znika. Archiwizowanie to krok, którego użyj, gdy chcesz tylko usunąć kontakt z drogi.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026