AdminGuide:RestAPI - Cronologia

Websoup: Versione segnata per la traduzione

2022-02-15T13:40:43Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 13:40, 15 feb 2022
Riga 154:		Riga 154:
	http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json		http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json

	== Manuale per le API relative al CDR == <!--T:38-->		== Manuale per le API relative al CDR == <!--T:38-->
	Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>		Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>
	E' possibile scaricare il documento da questo [https://www.kalliope.com/download/manuale-api-rest-cdr-v4/?wpdmdl=2100&masterkey link].		E' possibile scaricare il documento da questo [https://www.kalliope.com/download/manuale-api-rest-cdr-v4/?wpdmdl=2100&masterkey link].

Websoup: Versione segnata per la traduzione

2022-02-15T13:36:53Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 13:36, 15 feb 2022
Riga 51:		Riga 51:
	La procedura di calcolo della digestPassword richiede, oltre alla password dell'utente, una ulteriore stringa denominata '''salt''', univoca per tenant. Il salt può essere ottenuto dal KalliopePBX mediante una API REST apposita, invocabile in modo anonimo (senza autenticazione):		La procedura di calcolo della digestPassword richiede, oltre alla password dell'utente, una ulteriore stringa denominata '''salt''', univoca per tenant. Il salt può essere ottenuto dal KalliopePBX mediante una API REST apposita, invocabile in modo anonimo (senza autenticazione):

	rest/salt/<dominio_tenant>		<!--T:30-->
			rest/salt/<dominio_tenant>

			<!--T:31-->
	dove la stringa <dominio_tenant> ,nel caso di macchina single tenant, vale "default". Nel caso di sistema multi-tenant, per poter utilizzare le API a disposizione di pbxadmin, è possibile ottenere il salt relativo mediante l'API		dove la stringa <dominio_tenant> ,nel caso di macchina single tenant, vale "default". Nel caso di sistema multi-tenant, per poter utilizzare le API a disposizione di pbxadmin, è possibile ottenere il salt relativo mediante l'API

	rest/salt/pbxAdmin		<!--T:32-->
			rest/salt/pbxAdmin

	<!--T:16-->		<!--T:16-->
Riga 129:		Riga 132:
	La lista dettagliata e aggiornata delle API è consultabile direttamente tramite l'interfaccia web di KalliopePBX all'indirizzo		La lista dettagliata e aggiornata delle API è consultabile direttamente tramite l'interfaccia web di KalliopePBX all'indirizzo

	http[s]://''KALLIOPE_IP_ADDRESS''/api/doc		<!--T:33-->
			http[s]://''KALLIOPE_IP_ADDRESS''/api/doc

	<!--T:29-->		<!--T:29-->
	A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'interno della pagina di documentazione); tale collection integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).		A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'interno della pagina di documentazione); tale collection integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).

			<!--T:34-->
	Accedendo alla '''KalliopeTribe''' è disponibile un video che mostra l'utilizzo di tale collection per invocare in modo rapido le API di Kalliope.		Accedendo alla '''KalliopeTribe''' è disponibile un video che mostra l'utilizzo di tale collection per invocare in modo rapido le API di Kalliope.

			<!--T:35-->
	E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>		E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>
	* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.4.postman_collection.json.zip Collection Postman per firmware 4.9.4 - 4.9.8]		* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.4.postman_collection.json.zip Collection Postman per firmware 4.9.4 - 4.9.8]
Riga 142:		Riga 148:
	* [http://www.kalliopepbx.com/wiki/KalliopeLAM.postman_collection_4_11_3.zip Collection Postman per KalliopeLAM, firmware 4.11.3 o superiori]		* [http://www.kalliopepbx.com/wiki/KalliopeLAM.postman_collection_4_11_3.zip Collection Postman per KalliopeLAM, firmware 4.11.3 o superiori]

			<!--T:36-->
	E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:		E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:

	http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json		<!--T:37-->
			http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json

	== Manuale per le API relative al CDR ==		== Manuale per le API relative al CDR == <!--T:38-->
	Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>		Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>
	E' possibile scaricare il documento da questo [https://www.kalliope.com/download/manuale-api-rest-cdr-v4/?wpdmdl=2100&masterkey link].		E' possibile scaricare il documento da questo [https://www.kalliope.com/download/manuale-api-rest-cdr-v4/?wpdmdl=2100&masterkey link].

Websoup il 11:20, 5 nov 2021

2021-11-05T11:20:49Z

← Versione meno recente		Versione delle 11:20, 5 nov 2021
Riga 148:		Riga 148:
	== Manuale per le API relative al CDR ==		== Manuale per le API relative al CDR ==
	Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>		Dal momento che le API relative al CDR sono le più comunemente utilizzate abbiamo realizzato un semplice documento di approfondimento su questa famiglia di API.<br>
	E' possibile scaricare il documento da questo [https://www.~~kalliopepbx~~.com~~/it~~/download/~~documentazione-sviluppatori?download=120:~~manuale-api-rest-cdr-v4 link].		E' possibile scaricare il documento da questo [https://www.kalliope.com/download/manuale-api-rest-cdr-v4/?wpdmdl=2100&masterkey link].

	== Classi per la generazione degli header di autenticazione == <!--T:28-->		== Classi per la generazione degli header di autenticazione == <!--T:28-->

Rossi il 20:16, 15 mar 2021

2021-03-15T20:16:30Z

← Versione meno recente		Versione delle 20:16, 15 mar 2021
Riga 5:		Riga 5:
	<div class="noutonum" style="float: right">__TOC__</div>		<div class="noutonum" style="float: right">__TOC__</div>

			{{#evu:https://vimeo.com/508382279#t=37m26s
			\|alignment=right\|dimensions=350
			}}
	== Descrizione generale == <!--T:2-->		== Descrizione generale == <!--T:2-->
	KalliopePBX offre un set di API REST che possono essere invocate da sistemi esterni per compiere azioni di tipo dispositivo (es. creazione di un interno, generazione di un backup e download, ecc.) o di consultazione (download del registro chiamate, ecc.).		KalliopePBX offre un set di API REST che possono essere invocate da sistemi esterni per compiere azioni di tipo dispositivo (es. creazione di un interno, generazione di un backup e download, ecc.) o di consultazione (download del registro chiamate, ecc.).

Rossi il 12:07, 26 ott 2020

2020-10-26T12:07:45Z

← Versione meno recente		Versione delle 12:07, 26 ott 2020
Riga 138:		Riga 138:
	* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]
	* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]
	* [http://www.kalliopepbx.com/wiki/KalliopeLAM.postman_collection_4_11_3.zip Collection Postman per KalliopeLAM ~~(vers. fw~~ 4.11.3)]		* [http://www.kalliopepbx.com/wiki/KalliopeLAM.postman_collection_4_11_3.zip Collection Postman per KalliopeLAM, firmware 4.11.3 o superiori]

	E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:		E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:

Rossi il 12:06, 26 ott 2020

2020-10-26T12:06:51Z

← Versione meno recente		Versione delle 12:06, 26 ott 2020
Riga 138:		Riga 138:
	* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]
	* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]
			* [http://www.kalliopepbx.com/wiki/KalliopeLAM.postman_collection_4_11_3.zip Collection Postman per KalliopeLAM (vers. fw 4.11.3)]

	E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:		E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:

Stefano il 20:57, 10 ago 2020

2020-08-10T20:57:32Z

← Versione meno recente		Versione delle 20:57, 10 ago 2020
Riga 47:		Riga 47:

	<!--T:15-->		<!--T:15-->
	La procedura di calcolo della digestPassword richiede, oltre alla password dell'utente, una ulteriore stringa denominata '''salt''', univoca per tenant. Il salt può essere ottenuto dal KalliopePBX mediante una API REST apposita, invocabile in modo anonimo (senza autenticazione).		La procedura di calcolo della digestPassword richiede, oltre alla password dell'utente, una ulteriore stringa denominata '''salt''', univoca per tenant. Il salt può essere ottenuto dal KalliopePBX mediante una API REST apposita, invocabile in modo anonimo (senza autenticazione):

			rest/salt/<dominio_tenant>

			dove la stringa <dominio_tenant> ,nel caso di macchina single tenant, vale "default". Nel caso di sistema multi-tenant, per poter utilizzare le API a disposizione di pbxadmin, è possibile ottenere il salt relativo mediante l'API

			rest/salt/pbxAdmin

	<!--T:16-->		<!--T:16-->

Stefano il 14:55, 21 lug 2020

2020-07-21T14:55:39Z

← Versione meno recente		Versione delle 14:55, 21 lug 2020
Riga 125:		Riga 125:
	<!--T:29-->		<!--T:29-->
	A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'interno della pagina di documentazione); tale collection integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).		A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'interno della pagina di documentazione); tale collection integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).
	~~Sulla~~ KalliopeTribe è disponibile un video che mostra l'utilizzo di tale collection per invocare in modo rapido le API di Kalliope.
			Accedendo alla '''KalliopeTribe''' è disponibile un video che mostra l'utilizzo di tale collection per invocare in modo rapido le API di Kalliope.

	E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>		E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>

Stefano il 14:54, 21 lug 2020

2020-07-21T14:54:58Z

← Versione meno recente		Versione delle 14:54, 21 lug 2020
Riga 124:		Riga 124:

	<!--T:29-->		<!--T:29-->
	A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'~~itnerno~~ della documentazione) ~~che~~ integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).		A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'interno della pagina di documentazione); tale collection integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).
			Sulla KalliopeTribe è disponibile un video che mostra l'utilizzo di tale collection per invocare in modo rapido le API di Kalliope.

	E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>		E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>

Stefano il 14:53, 21 lug 2020

2020-07-21T14:53:08Z

← Versione meno recente		Versione delle 14:53, 21 lug 2020
Riga 119:		Riga 119:
	\|}		\|}
	-->		-->
	La lista dettagliata e aggiornata delle API è consultabile ~~fino alla versione firmware 4.8.x~~ tramite l'interfaccia web di KalliopePBX all'indirizzo		La lista dettagliata e aggiornata delle API è consultabile direttamente tramite l'interfaccia web di KalliopePBX all'indirizzo

	http[s]://''KALLIOPE_IP_ADDRESS''/api/doc		http[s]://''KALLIOPE_IP_ADDRESS''/api/doc

	E' inoltre ~~disponibile i lfile con~~ la ~~specifica swagger delle API, sempre scaricabile dal KalliopePBX,~~ all'indirizzo:		<!--T:29-->
			A partire dalla versione firmware '''4.9.4''' è disponibile inoltre una '''collection Postman''' (che sostituisce la sandbox integrata all'itnerno della documentazione) che integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).

	~~http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json~~

	~~<!--T:29-->~~
	A partire dalla versione firmware '''4.9.4''' è disponibile una '''collection Postman''' che integra anche il codice per aggiungere automaticamente l'header di autenticazione richiesto (è necessario solo impostare l'indirizzo IP del PBX e le credenziali username/password dell'utente con cui invocare l'API).
	E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>		E' possibile scaricare il file di collection per le varie versioni firmware dai seguenti link:<br>
	* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.4.postman_collection.json.zip Collection Postman per firmware 4.9.4 - 4.9.8]		* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.4.postman_collection.json.zip Collection Postman per firmware 4.9.4 - 4.9.8]
	* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/KalliopePBX%20API%204.9.9.postman_collection.json.zip Collection Postman per firmware 4.9.9 o superiori]
	* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]		* [https://www.kalliopepbx.com/wiki/Hotel%20API%204.9.9.postman_collection.zip Collection Postman per Modulo Hotel, firmware 4.9.9 o superiori]

			E' inoltre disponibile il file con la specifica swagger delle API, sempre scaricabile dal KalliopePBX, all'indirizzo:

			http[s]://''KALLIOPE_IP_ADDRESS''/api/doc.json

	== Manuale per le API relative al CDR ==		== Manuale per le API relative al CDR ==