Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL degli endpoint del servizio MailUpService: 

Endpoints

SOAP: http://services.mailupnet.it/1.0/MailUpService.svc 

REST: http://services.mailupnet.it/1.0/MailUpService.svc/rest

 

I metodi disponibili sono:

 

...

Methods

Authentication

Login and logout methods. Login returns an access key that can be used as parameter when calling other methods.

  • AuthenticationLogin
  • AuthenticationLogout

Filters

Create and delete MailUp filters.

  • FiltersCreatePersonalDataFilter
  • FiltersDeletePersonalDataFilter
  • FiltersCreateActivityFilter
  • FiltersDeleteActivityFilter
  • FiltersCreateGeographicFilter
  • FiltersDeleteGeographicFilter

Test

This method can be used to test the service

  • Ping

 

Restrictions

Il servizio supporta REST solo con parametri XML in POST (JSON non funziona, va in conflitto con il metodo di serializzazione utilizzato per SOAP)

 

L’unica risorsa raggiungibile in GET è:

  1. REST is supported only when XML parameters are passed with http POST method (Ping method is the only exception, which can be called using http GET http://services.mailupnet.it/1.0/MailUpService.svc/rest/Ping)
  2. JSON is not supported

 

How to use REST

Client configuration in ASP.NET

Add the following entries in web.config file to enable REST

Code Block
languagehtml/xml
<system.serviceModel>
	<serviceHostingEnvironment aspNetCompatibilityEnabled="true" />
	...
 
<behaviors>
	<endpointBehaviors>
		<behavior name="restBehavior">
			<webHttp/>
		</behavior>
	</endpointBehaviors>
</behaviors>
 
<service behaviorConfiguration="MailUp.WS.Host.Web.MailUpServiceBehavior" name="MailUp.WS.Service.MailUpService">
<endpoint  address="rest" binding="webHttpBinding" contract="MailUp.WS.Contract.IMailUpService" behaviorConfiguration="restBehavior"/>

 

Example

Code Block
Call http://services.mailupnet.it/1.0/MailUpService.svc/rest

...

/AuthenticationLogin
passing the following XML as parameter in HTTP POST:
 
<LoginRequest>
	<Username>xxxx</Username>
	<Password>yyyy</Password>
	<IdConsole>10001</IdConsole>
</LoginRequest>

 

Per configurare REST è sufficiente aggiungere le seguenti configurazioni nel web.config:

...