| POST | /soggetti/{SoggettoId}/contatti | Crea o aggiorna un contatto associato a un Soggetto. | Effettua un'operazione di Upsert basata sull'indirizzo Email all'interno dello stesso Soggetto. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| SoggettoId | path | int | Yes | ID univoco del Soggetto a cui associare il Contatto. |
| body | string | Yes | Indirizzo Email del contatto. Funge da chiave univoca per l'Upsert. | |
| Nome | body | string | Yes | Nome del contatto. |
| Cognome | body | string | Yes | Cognome del contatto. |
| TelFisso | body | string | No | Numero di telefono fisso. |
| TelMobile | body | string | No | Numero di telefono cellulare. |
| WebSite | body | string | No | URL del sito web del contatto o dell'azienda associata. |
| TipoTitoloId | body | int | No | ID del Titolo predefinito. |
| AltroTitolo | body | string | No | Titolo non presente nelle tabelle di lookup (salvato come testo libero). |
| TipoRuoloId | body | int | No | ID del Ruolo predefinito. |
| AltroRuolo | body | string | No | Ruolo non presente nelle tabelle di lookup (salvato come testo libero). |
| Note | body | string | No | Note libere aggiuntive relative al contatto. |
| Tags | body | string | No | Etichette (Tags) separate da virgola per la categorizzazione del contatto. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | int | No | |
| SoggettoId | form | int | No | |
| Nome | form | string | No | |
| Cognome | form | string | No | |
| form | string | No | ||
| TelFisso | form | string | No | |
| TelMobile | form | string | No | |
| WebSite | form | string | No | |
| TipoTitoloId | form | int | No | |
| Titolo | form | TipoTitolo | No | |
| AltroTitolo | form | string | No | |
| TipoRuoloId | form | int | No | |
| Ruolo | form | TipoRuolo | No | |
| AltroRuolo | form | string | No | |
| Tags | form | string | No | |
| Note | form | string | No | |
| IsLista | form | bool | No | |
| IsDisIscritto | form | bool | No | |
| IsBounced | form | bool | No | |
| DataCreazione | form | DateTime | No | |
| DataModifica | form | DateTime | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | int | No | |
| Descrizione | form | string | No | |
| AziendaId | form | int | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | int | No | |
| Descrizione | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=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>