Informazioni sulle chiavi API

Che cos’è un’API?

API sta per “Application Programming Interface” e per comprenderne le funzionalità può essere utile pensare all’API come un modo in cui diverse app possono dialogare. Per molti utenti, l’interazione principale con l’API avverrà tramite le chiavi API, che consentono ad altre applicazioni di accedere al tuo account senza che tu fornisca la password.

Trova la tua chiave API

Se desideri configurare un’integrazione con la tua applicazione e Memofly, è molto semplice, sono già pronte le API destinate al tuo account. Gli utenti con abbonamento Professional possono visualizzare le proprie chiavi API nella sezione “Avanzate” della propria Dashboard, pronte per essere integrate nella vostra applicazione.

Utilizza al meglio le nostre API

Alcuni esempi di chiamata API per integrare le funzionalità di Memofly nel vostro sistema, in diversi linguaggi di sviluppo

ESEMPIO 1 libreria cURL

ESEMPIO 2 stream_context_create

ESEMPIO 1 tramite chiamata ajax

Leggi gli eventi nel tuo calendario

get

https://memofly.it:3000/api/v0.1/calendar/read/:userid/calendar/:calendarid/start/:startdate/end/:enddate

Parametro

Campo	Tipo	Descrizione
userid	Number	id User in memofly ( unique ID ).
calendarid	Number	Id of google calendar.
startdate	Date	Min date for events.
enddate	Date	Max date for events.

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Imposta un evento nel tuo Google Calendar

post

https://memofly.it:3000/calendar/write

Parametro

Campo	Tipo	Descrizione
user_id	Number	id User in memofly ( unique ID ).
calendar_id	Number	Id of google calendar.
event	Object	Event to save in google calendar.

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Scrive un evento da schedulare da calendario di terzi

post

https://memofly.it:3000/calendar/writeeventext

Parametro

Campo	Tipo	Descrizione
user_id	Number	id User in memofly ( unique ID ).
calendar_id	Number	Id of google calendar.
event_id	String	Event id in google calendar.
tipology_id	Number	Id tipologia.
Summary	String	Title event in google calendar.
Description	String	Description event in google calendar.
Start	Datetime	Start event in google calendar.
End	Datetime	End event in google calendar.
Phones	Array	Array of numbers receiver.

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Ottieni le informazioni dell’abbonamento

get

https://memofly.it:3000/api/v0.1/usersubscription

Parametro

Campo	Tipo	Descrizione
user_id	Number	id User in memofly ( unique ID ).

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Ottieni i messaggi inviati dall’utente

get

https://memofly.it:3000/api/v0.1/submsgsend/:userid

Parametro

Campo	Tipo	Descrizione
user_id	Number	id User in memofly ( unique ID ).

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Ottieni i tipi di servizio di appuntamento

get

https://memofly.it:3000/api/v0.1/mem_appoint_tipo/:userid

Parametro

Campo	Tipo	Descrizione
user_id	Number	id User in memofly ( unique ID ).

Success 200

Campo	Tipo	Descrizione
res	Object	Result object.
status	String	Http code.
message	String	Result description.

Supporto API

Il nostro team di supporto Memofly non è preposto alla installazione e configurazione delle API nel tuo software. Se hai bisogno di uno sviluppatore che ti aiuti a configurare qualcosa utilizzando l’API, abbiamo delle soluzioni di consulenza software dedicata che potrebbero interessarti. Se sei uno sviluppatore che desidera creare la tua integrazione con Memofly, contattaci per maggiori informazioni, troveremo una soluzione per il tuo caso specifico e assistenza per l’integrazione.

Come utilizzare le API

Esempio

richiesta in linguaggio php tramite la libreria cURL

<?php

$url=’https://memofly.it:3000/api/v0.1/usersubscription/:userid’;

$auth_name=’yourauth_name’;

$auth_password=’yourauth_password’;

$ch=curl_init();

curl_setopt($ch,CURLOPT_URL,$url);

curl_setopt($ch,CURLOPT_HEADER,0); // 1 per verificare l’header di risposta

curl_setopt($ch,CURLOPT_POST,0); // 0 per impostare richiesta GET

curl_setopt($ch,CURLOPT_USERPWD,”$auth_name:$auth_password“);

curl_setopt($ch,CURLOPT_HTTPAUTH,CURLAUTH_BASIC);

curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,false);

curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);

curl_setopt($ch,CURLOPT_CONNECTTIMEOUT,3);

curl_setopt($ch,CURLOPT_TIMEOUT,20);

curl_setopt($ch,CURLOPT_HTTPHEADER,array(

‘Content-Type:application/json’)

);

$response=curl_exec($ch);

curl_close($ch);

$json_decode=json_decode($response);

?>

Esempio

richiesta in linguaggio php tramite la funzione stream_context_create

<?php
$url = ‘https://memofly.it:3000/api/v0.1/usersubscription/:userid’;

$auth_name = ‘your auth_name’;
$auth_password = ‘your auth_password’;

$context = stream_context_create(array(
“ssl”=>array(
“verify_peer”=>false,
“verify_peer_name”=>false,
),
‘http’ => array(
‘header’ => “Authorization: Basic ” . base64_encode(“$auth_name:$auth_password”),
),
));

$result = file_get_contents($url, false, $context);

$json_decode = json_decode($result);
?>

Esempio

richiesta in linguaggio javascript tramite chiamata ajax

var auth_name = ‘your auth name’;

var auth_password = ‘your auth pass’;

$.ajax({

url: ‘https://memofly.it:3000/api/v0.1/usersubscription/2’,

crossDomain: true,

headers: {

‘Authorization’: “Basic ” + btoa(auth_name + “:” + auth_password),

‘Content-Type’: ‘application/json’,

‘Access-Control-Allow-Origin’ : ‘*’,

},

method: ‘GET’,

dataType: ‘application/json’,

success: function (data) {

console.log(‘success: ‘ + data);

}

});