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:31]
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 22: Linea 20:
   * Dettaglio campagne create   * Dettaglio campagne create
  
-====   Elenco campagne create   ====+==== Elenco campagne create ====
  
 Restituisce l’elenco degli id di campagne di chiamate automatizzate dello specifico utente che ne ha fatto richiesta. Restituisce l’elenco degli id di campagne di chiamate automatizzate dello specifico utente che ne ha fatto richiesta.
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:**<?php $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);+**Esempio di codice PHP:**
  
-$resp curl_exec($curl); curl_close($curl); var_dump($resp);+<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);   Risposte: Risposta corretta: { "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" }, } Errore di autenticazione: { "result": "KO", "mgs": "problema di autenticazione" } //+<code> 
 +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> 
 + 
 +//  // 
 + 
 +==== 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 128: 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 150: 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 158: 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 192: Linea 293:
   Risposte:   Risposte:
  
-Risposta corretta: {+Risposta corretta: 
 + 
 +{
  
 <code> <code>
Linea 212: Linea 315:
 } }
  
-Errore di autenticazione: {+Errore di autenticazione: 
 + 
 +{
  
 <code> <code>
documentazione_api.1600788679.txt.gz · Ultima modifica: 2020/09/22 17:31 da enterprise