Questa funzione restituisce la lista di tutti i contatti presenti nella tua rubrica di Socialmailer.
I parametri da passare in input alla chiamata sono:
- account_token: il token di autenticazione del tuo account Socialmailer (string);
- account_username: lo username del tuo account Socialmailer (string);
- account_password: la password del tuo account Socialmailer (string);
In output la funzione restituisce:
- encoding: il charset di codifica della risposta (string);
- status: il valore dello stato restituito risposta (integer);
- message: la descrizione dello stato restituito dalla risposta (string);
- contacts_data: l'insieme dei dati richiesti (contactsList, tipo di dato composito definito nel WSDL);
Gli elementi che costituiscono l'array contacts_data appartengono al tipo contactData, che presenta la seguente struttura:
- contact-lastname: Cognome del contatto (string);
- contact-gender: Genere del contatto (genderValues, tipo di dato composito definito nel WSDL);
- contact-birthdate: Data di nascita del contatto (date);
- contact-street: Via di residenza del contatto (string);
- contact-number: Numero civico di residenza del contatto (string);
- contact-city: Città di residenza del contatto (string);
- contact-cap: CAP di residenza del contatto (int);
- contact-nation: Nazione del contatto (nationValues, tipo di dato composito definito nel WSDL);
- contact-district: Provincia di residenza del contatto (districtValues, tipo di dato composito definito nel WSDL);
- contact-telephone: Telefono del contatto (string);
- contact-fax: Fax del contatto(string);
- contact-mobile: Cellulare del contatto (string);
- contact-carrier: Operatore mobile del contatto (carrierValues, tipo di dato composito definito nel WSDL);
- contact-email: Indirizzo email del contatto (string);
- company-name: Ragione sociale dell'azienda (string);
- company-street: Via dell'azienda (string);
- company-number: Numero civico dell'azienda (string);
- company-city: Città dell'azienda (string);
- company-cap: CAP dell'azienda (int);
- company-nation: Nazione dell'azienda (nationValues, tipo di dato composito definito nel WSDL);
- company-district: Provincia dell'azienda (districtValues, tipo di dato composito definito nel WSDL);
- company-telephone: Telefono dell'azienda (string);
- company-fax: Fax dell'azienda (string);
- company-email: Indirizzo email dell'azienda (string);
- company-website: Sito internet dell'azienda (anyURI);
- settings-type: Tipologia (typeValues, tipo di dato composito definito nel WSDL);
- settings-language: Lingua predefinita del contatto (languageValues, tipo di dato composito definito nel WSDL);
- settings-note: Note (application/x-www-form-urlencoded) (string);
- social-facebook: Facebook (string);
- social-twitter: Twitter (string);
- social-linkedin: LinkedIn (string);
- social-plaxo: Plaxo (string);
- social-skype: Skype (string);
- social-msn: MSN Messenger (string);
Alcuni campi presenti nella risposta della funzione sono campi compositi definiti all'interno del file di definizione WSDL del web service.
Sono identificati dal tag tns (this name space) e riportano un elenco di valori predefiniti che possono essere assunti.
Essi sono: