Con TIM Open puoi partecipare alla community degli sviluppatori, pubblicare le tue soluzioni su TIM Digital Store, utilizzare e rivendere i servizi di TIM.

Guarda anche

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.

Recupera
GET/location/v1.1/{phoneNumber}

Ottieni la posizione del terminale mobile associato al numero fornito.

Example URI

GET /location/v1.1/3427706442
URI Parameters
HideShow
phoneNumber
string (required) Example: 3427706442
Request
HideShow
Headers
Content-Type: application/json
KeyId: d93decd9-b053-47ba-be26-d1da62942ff1
Response  200
HideShow
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"
}
Response  400
HideShow

La richiesta non è stata formulata in maniera corretta.

Headers
Content-Type: text/plain
Response  404
HideShow

Risorsa non trovata

Headers
Content-Type: text/plain
Response  403
HideShow

Errore di autenticazione

Headers
Content-Type: text/plain
Response  412
HideShow

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
Response  500
HideShow

Errore generico del server

Headers
Content-Type: application/json
Response  502
HideShow

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