| Entrambe le parti precedenti la revisione
Revisione precedente
Prossima revisione
|
Revisione precedente
|
documentazione_api [2020/09/22 17:29] enterprise |
documentazione_api [2020/09/22 18:11] (versione attuale) enterprise |
| ====== Sindaci in Contatto Documentazione API V 0.1 ====== | ====== Sindaci in Contatto Documentazione API v0.1 ====== |
| | |
| ====== ====== | |
| |
| **Introduzione ** | **Introduzione ** |
| * 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. |
| |
| **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> |
| |
| // // | // // |
| |
| ===== Dettaglio campagne create ===== | ==== 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> |
| | |
| | // // |
| | |
| | ==== 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/campaign/detail/<id_campagna|https://api.sindacincontatto.it/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/campaign/detail/1|https://api.sindacincontatto.it/campaign/detail/1]] -H "Content-Type: application/json" -d '{"username":" mia_user ","password":" mia_password"}' // | //Restituisce l’elenco degli id di campagne di chiamate automatizzate dello specifico utente che ne ha fatto richiesta. End Point: [[https://api.sindacincontatto.it/campaign/detail/<id_campagna|https://api.sindacincontatto.it/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/campaign/detail/1|https://api.sindacincontatto.it/campaign/detail/1]] -H "Content-Type: application/json" -d '{"username":" mia_user ","password":" mia_password"}' // |
| } | } |
| |
| 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 |
| </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); |
| 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); |
| Risposte: | Risposte: |
| |
| Risposta corretta: { | Risposta corretta: |
| | |
| | { |
| |
| <code> | <code> |
| } | } |
| |
| Errore di autenticazione: { | Errore di autenticazione: |
| | |
| | { |
| |
| <code> | <code> |