Class smsmarketSms

Description

Classe per l'invio di SMS e il controllo del credito residuo tramite richiesta POST/GET HTTP

Le impostazioni utilizzate di default sono:

  • Mittente: "SMSMarket"
  • Autenticazione: basata su IP con password inviata in chiaro
  • Qualità: Non impostata - Il default è l'utilizzo della modalità automatica

  • example: example not found

Located in /lib-smsmarket.inc.php (line 78)


	
			
Method Summary
smsmarketSms smsmarketSms (string $login, string $pwd, [string $from = 'SMSMarket'])
string getCredit ([mixed $type = 'credit'])
string sendMNC (array $numbers, [string $return_id = ''], integer 2)
string sendMultiSms (array $rcpts, string $data, [string $operation = 'TEXT'], [string $url = ''], [integer $return_id = ''])
string sendSms (string $rcpt, string $text, [string $act = ''], [string $operation = 'TEXT'], [string $url = ''], [integer $return_id = ''])
string sendStatus (string $id, string $type, [string $schema = '1'])
void setAuthPlain ()
void setDomain (string $domain)
void setFrom (string $from)
void setQualityAuto ()
void setQualityHigh ()
void setQualityLow ()
Methods
Constructor smsmarketSms (line 100)
smsmarketSms smsmarketSms (string $login, string $pwd, [string $from = 'SMSMarket'])
  • string $login: Username di accesso (Login)
  • string $pwd: Password di accesso
  • string $from: Intestazione mittente
getCredit (line 197)

Controlla il credito disponibile intermini di credito in euro o sms disponibili.

  • return: In caso di successo 'OK <valore>', dove <valore> è il numero di sms o il credito in euro a seconda del parametro type specificato.
    In caso di errore 'KO <testo_errore>
  • example: example not found
string getCredit ([mixed $type = 'credit'])
sendMNC (line 342)

Invia richiesta MNC

  • return: Risposta ricevuta dal gateway ("OK ..." o "KO ...").
  • example: example not found
string sendMNC (array $numbers, [string $return_id = ''], integer 2)
  • integer 2: Se uguale a 1 verrà restituito l'identificativo univo della spedizione da utilizzare per il controllo dello stato della spedizione tramite POST HTTP
  • array $numbers: Array di numeri telefonici con prefisso internazionale (es. +393201234567)
  • string $return_id: Testo del messaggio (max 160 caratteri)
sendMultiSms (line 290)

Invia un SMS a più destinatari

Nel caso sia utilizzata la qualità automatica con notifica, serà necessario passare un array associativo come primo parametro, le cui chiavi siano identificatori univoci di max 20 caratteri numerici.

  • return: Elenco di risposte ricevute dal gateway ("OK ..." o "KO ..."), separate da caratteri di "a capo" (\n)
  • example: example not found
string sendMultiSms (array $rcpts, string $data, [string $operation = 'TEXT'], [string $url = ''], [integer $return_id = ''])
  • array $rcpts: Array di numeri telefonici con prefisso internazionale (es. +393201234567)
  • string $data: Testo del messaggio (max 160 caratteri)
  • string $operation: Tipologia di messaggio (TEXT, WAPPUSH)
  • string $url: Indirizzo URL cui dovrà collegarsi il destinatario in caso di SMS WAPPUSH
  • integer $return_id: Se uguale a 1 verrà restituito l'identificativo univo della spedizione da utilizzare per il controllo dello stato della spedizione tramite POST HTTP
sendSms (line 231)

Invia un SMS

Nel caso sia utilizzata la qualità automatica con notifica, serà necessario passare un identificatore univoco di max 20 * caratteri numerici come terzo parametro. Qualora non venisse impostato, ne verrà generato uno casuale in maniera automatica, per permettere il corretto invio del messaggio.

  • return: Risposta ricevuta dal gateway ("OK ..." o "KO ..."). In caso di successo verrà visualizzato anche il costo del messaggio inviato
  • example: example not found
string sendSms (string $rcpt, string $text, [string $act = ''], [string $operation = 'TEXT'], [string $url = ''], [integer $return_id = ''])
  • string $rcpt: Numero telefonico con prefisso internazionale (es. +393201234567)
  • string $text: Testo del messaggio (max 160 caratteri)
  • string $act: Identificatore univoco del messaggio da utilizzare nel caso sia richiesta la notifica
  • string $operation: Tipologia di messaggio (TEXT, WAPPUSH)
  • string $url: Indirizzo URL cui dovrà collegarsi il destinatario in caso di SMS WAPPUSH
  • integer $return_id: Se uguale a 1 verrà restituito l'identificativo univo della spedizione da utilizzare per il controllo dello stato della spedizione tramite POST HTTP
sendStatus (line 371)

Controllo satto delle spedizioni

  • return: Risposta ricevuta dal gateway ("OK ..." o "KO ...").
  • example: example not found
string sendStatus (string $id, string $type, [string $schema = '1'])
  • string $id: Identificativo univoco della spedizione
  • string $type: Tipo di report (queue, notify, mnc)
  • string $schema: Schema del report
setAuthPlain (line 134)

Utilizza l'autenticazione con password in chiaro basata sull'IP

void setAuthPlain ()
setDomain (line 125)

Imposta l'indirizzo URL del dominio dell'amministratore/rivenditore sul quale dovranno loggarsi gli eventuali clienti L'URL deve essere nel formato 'http://www.miodominio.it'

void setDomain (string $domain)
  • string $domain: URL
setFrom (line 114)

Imposta intestazione mittente

Il mittente può essere composto da un massimo di 11 caratteri alfanumerici o un numero telefonico con prefisso internazionale.

void setFrom (string $from)
  • string $from: Intestazione mittente
setQualityAuto (line 175)

Imposta la qualità messaggi automatica

void setQualityAuto ()
setQualityAutoNotify (line 183)

Imposta la qualità messaggi automatica con notifica

void setQualityAutoNotify ()
setQualityDefault (line 143)

Imposta la qualità messaggi al default dell'account

void setQualityDefault ()
setQualityHigh (line 167)

Imposta la qualità messaggi come alta

void setQualityHigh ()
setQualityLow (line 151)

Imposta la qualità messaggi come bassa

void setQualityLow ()
setQualityMedium (line 159)

Imposta la qualità messaggi come media

void setQualityMedium ()

Documentation generated on Thu, 21 Sep 2006 16:43:38 +0200 by phpDocumentor 1.3.0RC3