Panoramica ¶
Introduzione
La TIM API - Terminal Location abilita le applicazioni di Business Client, Content Service Provider e Sviluppatori a tracciare la posizione di un terminale mobile.
Sicurezza ¶
Autenticazione
L’API TerminalLocation descritta in questo documento adotterà il meccanismo di autenticazione che si basa su un API-Key. L’API-Key sarà fornita nel parametro KeyId
dell’header http della richiesta.
Localizzazione ¶
Posizione ¶
La risorsa Posizione permette di recuperare le informazioni di localizzazione di un cliente TIM.
RecuperaGET/location/v1.1/{phoneNumber}
Ottieni la posizione del terminale mobile associato al numero fornito.
Example URI
- phoneNumber
string
(required) Example: 3427706442
Headers
Content-Type: application/json
KeyId: d93decd9-b053-47ba-be26-d1da62942ff1
200
Headers
Content-Type: application/json
Body
"result": {
"status": "OK",
"description": "Localizzazione Ricevuta.",
"values": {
"latitudine": "41.25396",
"longitudine": "13.616616",
"altitudine": "null",
"accuracy": "939",
"timestamp": "2017-06-13T13:09:48.000+02:00"
}
400
La richiesta non è stata formulata in maniera corretta.
Headers
Content-Type: text/plain
404
Risorsa non trovata
Headers
Content-Type: text/plain
403
Errore di autenticazione
Headers
Content-Type: text/plain
412
Le condizioni per effettuare la richiesta non sono soddisfatte, in particolare l’invocazione dell’API non è permessa per uno dei seguenti motivi:
-
Sottoscrizione non attiva.
-
Frequenza traffico richieste superata.
-
Soglia richieste superata.
Headers
Content-Type: application/json
500
Errore generico del server
Headers
Content-Type: application/json
502
Il server ha ricevuto una risposta non valida dal server a cui ha eseguito l’accesso per soddisfare la richiesta.
Headers
Content-Type: application/json