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 - InviaSMS permette di inviare SMS Application to Person (A2P) da applicazioni. In particolare consente di: inviare SMS MT (Mobile Terminated-MT) verso gli utenti finali.

Sicurezza

Autenticazione

La TIM API - InviaSMS 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.

Messaggio

La risorsa messaggio esposta tramite questa API

Messaggio

Invia Messaggio
POST/sms/v1.1

Invio di un SMS MT da un’applicazione di terze parti verso utente finale

Example URI

POST /sms/v1.1
Request
HideShow
Headers
Content-Type: application/json
KeyId: d93decd9-b053-47ba-be26-d1da62942ff1
Body
{
  "phoneNumber": "3928308999",
  "text": "Hello, world!"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "phoneNumber": {
      "type": "string"
    },
    "text": { 
      "type": "string"
    }
  },
  "required": [
    "phoneNumber",
    "text"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "result": {
    "status": "OK",
    "description": "Messaggio inviato con esito positivo."
  }
}
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