Siirry sisältöön
Tarkistettu

Lisää kontakti

Tallenna henkilö osoitekirjaan käsin ja käsittele tapaus, jossa hän on jo siinä.

create_contact on käsin kirjoitettu polku osoitekirjaan, sama koontinäytön oman "lisää kontakti" -lomakkeen takana oleva: nimi ja sähköposti, puhelin ja yritys mukana. Kirja on avaimistettu sähköpostilla, joten jo olemassa olevan lähettäminen ei ole virhe: se palaa tavallisena onnistumisena, joka nimeää kontaktin, joka sinulla jo on.

Metodi

POST/cpi/create_contact
user

Create Contact

Adds a person to the contact book by hand, from typed details rather than from a received message. Takes only the fields a contact has, name, email, phone, company, job title and its kind (personal or business, which then needs no model to classify it), and ignores anything else the caller happens to hold, such as a shipping address. The email is the book's key, so it is required and a repeat of one already filed returns the existing contact instead of a second copy.

Läpikäynti

Lähetä neljä kenttää, jotka kontaktilla on

name ja email ovat ainoat kaksi, joita create_contact vaatii. source on oletuksena manual ja context oletuksena Added by hand, jos jätät ne pois; molemmat näkyvät kontaktin omassa toimintahistoriassa.

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "name": "Priya Shah",
    "email": "[email protected]",
    "phone": "+1 555 0110",
    "company": "Northwind"
  }'
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: 'Priya Shah',
    email: '[email protected]',
    phone: '+1 555 0110',
    company: 'Northwind',
  }),
});
const { code, data } = await res.json();
if (code > 0 && data.existed) console.log('already in the book:', data.contact_id);
else if (code > 0) console.log('created:', data.contact_id);
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Priya Shah',
        'email': '[email protected]',
        'phone': '+1 555 0110',
        'company': 'Northwind',
    },
)
body = res.json()
if body['code'] > 0 and body['data']['existed']:
    print('already in the book:', body['data']['contact_id'])
elif body['code'] > 0:
    print('created:', body['data']['contact_id'])

Vastaus

json
{
  "code": 1,
  "data": {
    "contact_id": "cnt_a91f0e",
    "name": "Priya Shah",
    "email": "[email protected]",
    "existed": false
  }
}

existed: true on kaksoiskappaleen polku: sähköposti oli jo kirjassa, ja contact_id nimeää kontaktin, jolla se jo oli, ei uutta. Haarauta existed:n, ei code:n mukaan erottaaksesi tapaukset, sillä molemmat palaavat arvolla code: 1.

phone ja company tallennetaan kontaktille, mutta niitä ei kaiuteta tässä vastauksessa; lue ne takaisin get_contacts:lla tai get_contact_members:lla, jos haluat varmistaa, mitä tallennettiin.

Virheet

Seuraavaksi