Gemma.WebApi

<back to all web services

UpsertContattoSoggettoRequest

Contatti
Requires Authentication
The following routes are available for this service:
POST/soggetti/{SoggettoId}/contattiCrea o aggiorna un contatto associato a un Soggetto.Effettua un'operazione di Upsert basata sull'indirizzo Email all'interno dello stesso Soggetto.
UpsertContattoSoggettoRequest Parameters:
NameParameterData TypeRequiredDescription
SoggettoIdpathintYesID univoco del Soggetto a cui associare il Contatto.
EmailbodystringYesIndirizzo Email del contatto. Funge da chiave univoca per l'Upsert.
NomebodystringYesNome del contatto.
CognomebodystringYesCognome del contatto.
TelFissobodystringNoNumero di telefono fisso.
TelMobilebodystringNoNumero di telefono cellulare.
WebSitebodystringNoURL del sito web del contatto o dell'azienda associata.
TipoTitoloIdbodyintNoID del Titolo predefinito.
AltroTitolobodystringNoTitolo non presente nelle tabelle di lookup (salvato come testo libero).
TipoRuoloIdbodyintNoID del Ruolo predefinito.
AltroRuolobodystringNoRuolo non presente nelle tabelle di lookup (salvato come testo libero).
NotebodystringNoNote libere aggiuntive relative al contatto.
TagsbodystringNoEtichette (Tags) separate da virgola per la categorizzazione del contatto.
ContattoDto Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
SoggettoIdformintNo
NomeformstringNo
CognomeformstringNo
EmailformstringNo
TelFissoformstringNo
TelMobileformstringNo
WebSiteformstringNo
TipoTitoloIdformintNo
TitoloformTipoTitoloNo
AltroTitoloformstringNo
TipoRuoloIdformintNo
RuoloformTipoRuoloNo
AltroRuoloformstringNo
TagsformstringNo
NoteformstringNo
IsListaformboolNo
IsDisIscrittoformboolNo
IsBouncedformboolNo
DataCreazioneformDateTimeNo
DataModificaformDateTimeNo
TipoTitolo Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DescrizioneformstringNo
AziendaIdformintNo
TipoRuolo Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DescrizioneformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /soggetti/{SoggettoId}/contatti HTTP/1.1 
Host: gemma.api.kerberos.energy 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<UpsertContattoSoggettoRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Gemma.WebApi.ServiceModel.Requests">
  <AltroRuolo>String</AltroRuolo>
  <AltroTitolo>String</AltroTitolo>
  <Cognome>String</Cognome>
  <Email>String</Email>
  <Nome>String</Nome>
  <Note>String</Note>
  <SoggettoId>0</SoggettoId>
  <Tags>String</Tags>
  <TelFisso>String</TelFisso>
  <TelMobile>String</TelMobile>
  <TipoRuoloId>0</TipoRuoloId>
  <TipoTitoloId>0</TipoTitoloId>
  <WebSite>String</WebSite>
</UpsertContattoSoggettoRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ContattoDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Gemma.WebApi.ServiceModel.Responses">
  <AltroRuolo>String</AltroRuolo>
  <AltroTitolo>String</AltroTitolo>
  <Cognome>String</Cognome>
  <DataCreazione>0001-01-01T00:00:00</DataCreazione>
  <DataModifica>0001-01-01T00:00:00</DataModifica>
  <Email>String</Email>
  <Id>0</Id>
  <IsBounced>false</IsBounced>
  <IsDisIscritto>false</IsDisIscritto>
  <IsLista>false</IsLista>
  <Nome>String</Nome>
  <Note>String</Note>
  <Ruolo xmlns:d2p1="http://schemas.datacontract.org/2004/07/Gemma.WebApi.ServiceModel.Types">
    <d2p1:Descrizione>String</d2p1:Descrizione>
    <d2p1:Id>0</d2p1:Id>
  </Ruolo>
  <SoggettoId>0</SoggettoId>
  <Tags>String</Tags>
  <TelFisso>String</TelFisso>
  <TelMobile>String</TelMobile>
  <TipoRuoloId>0</TipoRuoloId>
  <TipoTitoloId>0</TipoTitoloId>
  <Titolo xmlns:d2p1="http://schemas.datacontract.org/2004/07/Gemma.WebApi.ServiceModel.Types">
    <d2p1:AziendaId>0</d2p1:AziendaId>
    <d2p1:Descrizione>String</d2p1:Descrizione>
    <d2p1:Id>0</d2p1:Id>
  </Titolo>
  <WebSite>String</WebSite>
</ContattoDto>