API e Webservice

Specifiche

Benvenuti nella nostra API dedicata ai fornitori di servizi informatici per l'immobiliare, vi troverete tutti i dettagli di un'agenzia con i suoi annunci, i suoi contatti e alcuni dei suoi parametri. In funzione dei vostri diritti, potrete anche inviare informazioni come i clienti potenziali.

	L'API di apimo™ funziona in formato JSON
Protocollo	Distribuiamo un certificato valido e firmato per tutti i metodi dell'API. Accertatevi che le vostre biblioteche di connessione comprendano il protocollo HTTPS.
Token	Per usare questa API, dovete richiederci un identificativo numerico e un Token. (request a token)
Limite	Quota gratuita di 1000 richieste giornaliere e di 10 richieste al secondo (la quota è rinnovata tutti i giorni a mezzanotte CEST)
Charset	UTF-8
Content	application/json
Lingue	fr (francese) , it (italiano) , de (tedesco) , es (spagnolo) , en (inglese) , nl (olandese) , zh (cinese) , ru (russo) , sv (svedese) , ar (arabo) , he (ebraico) , nb (norvegese bokmål) , pt (portoghese) , fa (persiano) , lb (lussemburghese) , km (khmer) , tr (turco) , lo (lao)

	L'API di apimo™ integra 4 metodi HTTP per interagire con le risorse.
GET	Fate una richiesta GET per recuperare dati. Le richieste GET non provocano mai aggiornamenti o modifiche dei dati.
POST	Fate una richiesta POST per creare risorse.
PUT	Fate una richiesta PUT per aggiornare risorse.
DELETE	Fate una richiesta DELETE per sopprimere una risorsa (con cautela!).

Webservices

Catalogs

Metodo HTTP	Percorso	Funzione
get	/catalogs	Get a list of catalogs
get	/catalogs/{catalogs_id}	Get a specific catalog

Agencies

Metodo HTTP	Percorso	Funzione
get	/agencies	Retrieve the business units list

Agencies/actions

Metodo HTTP	Percorso	Funzione
post	/agencies/{agency_id}/actions	Create a new action
put	/agencies/{agency_id}/actions/{action_id}	Update an action

Agencies/contacts

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/contacts	Retrieve the contacts list
post	/agencies/{agency_id}/contacts	Create a new contact
put	/agencies/{agency_id}/contacts/{contact_id}	Update a contact

Agencies/contracts

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/contracts	Retrieve the contracts list

Agencies/leads

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/leads	Retrieve the leads list
post	/agencies/{agency_id}/leads	Create a new lead

Agencies/properties

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/properties	Retrieve the properties list
post	/agencies/{agency_id}/properties	Create a new property
put	/agencies/{agency_id}/properties/{property_id}	Update a property
post	/agencies/{agency_id}/properties/{property_id}/medias	Add/embed a media (virtual tour, video …)
delete	/agencies/{agency_id}/properties/{property_id}/medias/{media_id}	Delete a media (virtual tour, video …)
post	/agencies/{agency_id}/properties/{property_id}/pictures	Update a picture
delete	/agencies/{agency_id}/properties/{property_id}/pictures/{picture_id}	Delete a picture inside a property
post	/agencies/{agency_id}/properties/{property_id}/documents	Add a document
delete	/agencies/{agency_id}/properties/{property_id}/documents/{document_id}	Delete a document inside a property
post	/agencies/{agency_id}/properties/{property_id}/comments	Add/Update a comment
get	/agencies/{agency_id}/properties/{property_id}/providers	Provider list for a specific property
post	/agencies/{agency_id}/properties/{property_id}/providers	Grant property access to a provider
PUT	/agencies/{agency_id}/properties/{property_id}/provider	Update information related to the publishing of the property
get	/agencies/{agency_id}/properties/{property_id}/crossings	Crossing list (matched requests) for a specific property

Agencies/requests

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/requests	Retrieve the requests list
post	/agencies/{agency_id}/requests	Create a new request
put	/agencies/{agency_id}/requests/{request_id}	Update a request
get	/agencies/{agency_id}/requests/{request_id}/crossings	Crossing list (matched properties) for a specific request

Agencies/residences

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/residences	Retrieve the residences list

Agencies/users

Metodo HTTP	Percorso	Funzione
get	/agencies/{agency_id}/users	Retrieve the users list
get	/agencies/{agency_id}/users/{user_id}/actions	Retrieve actions list of a specific user

Webservice & API