Strumenti Utente

Strumenti Sito


documentazione_api

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

Entrambe le parti precedenti la revisione Revisione precedente
Prossima revisione
Revisione precedente
documentazione_api [2020/09/22 17:40]
enterprise
documentazione_api [2020/09/22 18:11] (versione attuale)
enterprise
Linea 1: Linea 1:
 ====== Sindaci in Contatto Documentazione API v0.1 ====== ====== Sindaci in Contatto Documentazione API v0.1 ======
- 
-======   ====== 
  
 **Introduzione ** **Introduzione **
Linea 36: Linea 34:
  
 **Esempio di codice CURL: ** **Esempio di codice CURL: **
- 
-curl -X POST [[https://api.sindacincontatto.it/campaign/list|https://api.sindacincontatto.it/campaign/list]] 
 <code> <code>
  
 +curl -X POST https://api.sindacincontatto.it/campaign/list
  -H "Content-Type: application/json"  -H "Content-Type: application/json"
-       -d '{"username":" mia_user ","password":" mia_password"}'+ -d '{"username":" mia_user ","password":" mia_password"}'
  
 </code> </code>
  
 **Esempio di codice PHP:** **Esempio di codice PHP:**
 +
 +<code>
 +$url = "https://api.sindacincontatto.it/campaign/list";
 +
 +$curl = curl_init($url);
 +curl_setopt($curl, CURLOPT_URL, $url);
 +curl_setopt($curl, CURLOPT_POST, true);;
 +curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
 +
 +$headers = array();
 +$headers["Content-Type"] = "application/json";
 +
 +curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
 +
 +$data = '{"username":"mia_user","password":"mia_password"}';
 +
 +curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
 +
 +//for debug only!
 +curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
 +curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
 +
 +$resp = curl_exec($curl);
 +curl_close($curl);
 +var_dump($resp);
 +
 +</code>
  
 **Esempio javascript/ajax** **Esempio javascript/ajax**
  
-var url = "https://api.sindacincontatto.it/campaign/list"; var xhr = new XMLHttpRequest(); xhr.open("POST", url); xhr.setRequestHeader("Content-Type", "application/json"); xhr.onreadystatechange = function () { if (xhr.readyState === 4) { console.log(xhr.status); console.log(xhr.responseText); }}; var data = '{"username":"mia_user","password":"mia_password"}'; xhr.send(data);   //+<code> 
 +var url = "https://api.sindacincontatto.it/campaign/list";
  
-//Risposte: //+var xhr = new XMLHttpRequest(); 
 +xhr.open("POST", url);
  
-//Risposta corretta: //+xhr.setRequestHeader("Content-Type", "application/json");
  
-//"response": "OK", "data":"id_campagna": "1", "nome_campagna": "Campagna1", "data_attivazione": "2017-06-06 11:14:33" }, { "id_campagna": "2", "nome_campagna": "Campagna2", "data_attivazione": "2017-10-04 17:12:28" }, //+xhr.onreadystatechange = function () { 
 +   if (xhr.readyState === 4) { 
 +      console.log(xhr.status); 
 +      console.log(xhr.responseText); 
 +   }};
  
-//Errore di autenticazione//+var data = '{"username":"mia_user","password":"mia_password"}';
  
-//{ "result": "KO", "mgs": "problema di autenticazione" } //+xhr.send(data); 
 + 
 +</code> 
 + 
 +//  // 
 + 
 +==== Risposte: ==== 
 + 
 +=== Risposta corretta: === 
 + 
 +<code> 
 +
 +  "response": "OK", 
 +  "data":
 +    { 
 +      "id_campagna": "1", 
 +      "nome_campagna": "Campagna1", 
 +      "data_attivazione": "2017-06-06 11:14:33" 
 +    }, 
 +    { 
 +      "id_campagna": "2", 
 +      "nome_campagna": "Campagna2", 
 +      "data_attivazione": "2017-10-04 17:12:28" 
 +    }, 
 +
 + 
 +</code> 
 + 
 +**Errore di autenticazione:** 
 + 
 +<code> 
 +{ 
 +    "result": "KO", 
 +    "mgs": "problema di autenticazione" 
 +} 
 + 
 +</code>
  
 //  // //  //
Linea 134: Linea 200:
 } }
  
-  Ambito campagne SMS+===== Ambito campagne SMS =====
  
-Funzionalità disponibili: • Elenco campagne create • Dettaglio campagne create+Funzionalità disponibili: 
 + 
 +  * Elenco campagne create 
 +  * Dettaglio campagne create
  
 Elenco campagne create Elenco campagne create
Linea 156: Linea 225:
 </code> </code>
  
-  Esempio di codice PHP: <?php $url = "https://api.sindacincontatto.it/sms_campaign/list"; $curl = curl_init($url); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, true);; curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $headers = array(); $headers["Content-Type"] = "application/json"; curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); $data = '{"username":"mia_user","password":"mia_password"}'; curl_setopt($curl, CURLOPT_POSTFIELDS, $data); //for debug only! curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);+  Esempio di codice PHP: 
 + 
 +<?php $url = "https://api.sindacincontatto.it/sms_campaign/list"; $curl = curl_init($url); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, true);; curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $headers = array(); $headers["Content-Type"] = "application/json"; curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); $data = '{"username":"mia_user","password":"mia_password"}'; curl_setopt($curl, CURLOPT_POSTFIELDS, $data); //for debug only! curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
  
 $resp = curl_exec($curl); curl_close($curl); var_dump($resp); $resp = curl_exec($curl); curl_close($curl); var_dump($resp);
Linea 164: Linea 235:
   Esempio javascript/ajax   Esempio javascript/ajax
  
-var url = "https://api.sindacincontatto.it/sms_campaign/list"; var xhr = new XMLHttpRequest(); xhr.open("POST", url); xhr.setRequestHeader("Content-Type", "application/json"); xhr.onreadystatechange = function () { if (xhr.readyState === 4) { console.log(xhr.status); console.log(xhr.responseText); }}; var data = '{"username":"mia_user","password":"mia_password"}'; xhr.send(data);   Risposte: Risposta corretta: { "response": "OK", "data": [ { "id_campagna": "1", "nome_campagna": "Campagna SMS 1", "data_attivazione": "2017-06-06 11:14:33" }, { "id_campagna": "2", "nome_campagna": "Campagna SMS 2", "data_attivazione": "2017-10-04 17:12:28" }, } Errore di autenticazione: { "result": "KO", "mgs": "problema di autenticazione" }   Dettaglio campagne create Restituisce l’elenco degli id di campagne di chiamate automatizzate dello specifico utente che ne ha fatto richiesta. End Point: [[https://api.sindacincontatto.it/sms_campaign/detail/<id_campagna|https://api.sindacincontatto.it/sms_campaign/detail/<id_campagna]]> Nodo specifico: <id_campagna> : id della campagna di cui si desidera ricevere le informazioni di dettaglio Parametri JSON: • username: il proprio username • password: la propria password esempio formattazione: {“username”:”mia_user”,”password”:”mia_password”} Esempio di codice CURL: curl -X POST [[https://api.sindacincontatto.it/sms_campaign/detail/1|https://api.sindacincontatto.it/sms_campaign/detail/1]] -H "Content-Type: application/json" -d '{"username":" mia_user ","password":" mia_password"}'   Esempio di codice PHP: <?php $url = "https://api.sindacincontatto.it/sms_campaign/detail/1";+var url = "https://api.sindacincontatto.it/sms_campaign/list"; var xhr = new XMLHttpRequest(); xhr.open("POST", url); xhr.setRequestHeader("Content-Type", "application/json"); xhr.onreadystatechange = function () { if (xhr.readyState === 4) { console.log(xhr.status); console.log(xhr.responseText); }}; var data = '{"username":"mia_user","password":"mia_password"}'; xhr.send(data);   Risposte: Risposta corretta: { "response": "OK", "data": [ { "id_campagna": "1", "nome_campagna": "Campagna SMS 1", "data_attivazione": "2017-06-06 11:14:33" }, { "id_campagna": "2", "nome_campagna": "Campagna SMS 2", "data_attivazione": "2017-10-04 17:12:28" }, } Errore di autenticazione: { "result": "KO", "mgs": "problema di autenticazione" }   // 
 + 
 +//Dettaglio campagne create // 
 + 
 +//Restituisce l’elenco degli id di campagne di chiamate automatizzate dello specifico utente che ne ha fatto richiesta. // 
 + 
 +//End Point: [[https://api.sindacincontatto.it/sms_campaign/detail/<id_campagna|https://api.sindacincontatto.it/sms_campaign/detail/<id_campagna]]> // 
 + 
 +//Nodo specifico: <id_campagna> : id della campagna di cui si desidera ricevere le informazioni di dettaglio // 
 + 
 +//Parametri JSON: // 
 + 
 +//• username: il proprio username // 
 + 
 +//• password: la propria password // 
 + 
 +//esempio formattazione: {“username”:”mia_user”,”password”:”mia_password”} // 
 + 
 +//Esempio di codice CURL: // 
 + 
 +//curl -X POST [[https://api.sindacincontatto.it/sms_campaign/detail/1|https://api.sindacincontatto.it/sms_campaign/detail/1]] -H "Content-Type: application/json" -d '{"username":" mia_user ","password":" mia_password"}'   // 
 + 
 +//Esempio di codice PHP: // 
 + 
 +//<?php $url = "https://api.sindacincontatto.it/sms_campaign/detail/1";
  
 $curl = curl_init($url); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, true);; curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $curl = curl_init($url); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, true);; curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
Linea 198: Linea 293:
   Risposte:   Risposte:
  
-Risposta corretta: {+Risposta corretta: 
 + 
 +{
  
 <code> <code>
Linea 218: Linea 315:
 } }
  
-Errore di autenticazione: {+Errore di autenticazione: 
 + 
 +{
  
 <code> <code>
documentazione_api.1600789257.txt.gz · Ultima modifica: 2020/09/22 17:40 da enterprise