İçeriğe geç

Kişiler

Birlikte çalıştığınız kişiler ve şirketler.

Kişiler aç
20 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

Kişilerin kendine ait bir mikro hizmeti yoktur. Herkese açık yöntemleri, Profiller'i de tutan hesap mikro hizmetine ve arkadaşlık istekleri için ekip mikro hizmetine aittir. Her biri, API anahtarını kullandığınız hesap adına çalışır.

Gruplar, etiketler, özel alanlar, İletişimde kalın, yinelenen denetimi, içe aktarma ve plan seçme için bugün herkese açık bir yöntem yoktur. Bunlar dashboard'da yapılır.

Anahtarınızla bir yönteme istek gönderin:

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

Reddedilen bir istek negatif bir code yanıtlar ve nedenini data içinde söyler. Aşağıdaki yöntemlerin çoğu ayrıca, ana çalışma alanınızdan başka sahibi olduğunuz bir çalışma alanında işlem yapmak için isteğe bağlı bir workspace_id alır.

Kişileri okuma

get_contacts kişileri listeler.

  • _id veya contact_id tek bir kişi döndürür.
  • search listeyi bir arama dizesine, name ise bir ada göre süzer.
  • filter_type listeyi daraltır, örneğin archived, shared, pinned, favorites veya online. Verilmezse etkin kişileri, bekleyen bağlanma istekleriyle birlikte listeler.
  • with_requests değeri true olarak ayarlanırsa gönderilen ve alınan bekleyen istekler, süzülmüş bir listeye de eklenir.
  • tag bir etiketi taşıyan kişileri listeler, folder_id bir klasörü listeler (hiçbir klasörde olmayan kişiler için __none__ gönderin) ve group_id bir kişi grubunun üyelerini listeler.
  • profile_id, sizin başka bir profilinizin kişilerini okur. limit, skip ve bookmark listeyi sayfalar.

Kişi ekleme

create_contact bir kişiyi elle ekler. Zorunlu olan name ve email alır; isteğe bağlı olarak phone, company, job_title ve bir modelin tahmin etme zahmetini ortadan kaldıran, personal veya business olarak ayarlanan account_type alır.

  • E-posta, defterin anahtarıdır. Zaten sahip olduğunuz bir tanesini göndermek, ikinci bir kopya yerine mevcut kişiyi döndürür.
  • source, kişinin nereden geldiğini kaydeder; hiçbir şey göndermezseniz manual olur ve context, kişinin etkinliğinde görünen tek bir satırdır.
  • profile_id, kişiyi sizin başka bir profilinizin altına kaydeder.
  • Kimseye bir şey sorulmaz ve e-posta gönderilmez. Dashboard'daki Davet göndermeden ekle ile aynıdır.

Koddan bir liste getirmek için her kişi için bir kez çağırın.

Arkadaşlık istekleri

  • add_contact_member, access_email veya to_uid ile bulunan başka bir Xuda kullanıcısına istek gönderir.
  • get_contact_members, isteklerinizi ve bağlantılarınızı, her biri diğer kişinin kartıyla listeler. stat, listelemek için bir istek durumunu ya da birkaçını alır.
  • unfriend_contact, bir contact_id alır ve bağlantıyı sonlandırır. Kişi defterinizde kalır.

Bir kişiyi düzenleme

Bunların her biri bir contact_id alır.

Arşivleme ve silme

Silme geri alınamaz

delete_contact ile silinen bir kişi gider. Bir kişiyi yalnızca yoldan çekmek istiyorsanız kullanılacak adım arşivlemektir.

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026