Indice
- Wiki
- API SEMPLIFICATE
- Utilità
Per poter utilizzare le API l'utente dovrà abilitare l'accesso e configurare il suo IP nel pannello di configurazione della propria area riservata all'indirizzo: https://www.smskdev.it/highway
eseguito il login accedere dal menù alla sezione
Il Mio Account > Configurazione Utente
Scegliere SI dalla dropdown in corrispondenza dell'opzione “Abilita Webservice” Specificare l'IP o gli IP dai quali saranno lanciate le chiamate nel campo in corripsondeza WebService Ip Range, per aprire il Webservice su tutte le reti specificare *.*.*.*
Per l'invio di un SMS é sufficiente una chiamata HTTPS
IL TESTO DELL'SMS DEVE ESSERE CODIFICA SECONDO LO STANDARD URLENCODE
ESEMPIO di chiamata per invio SMS https://www.smskdev.it/highway/send.php?user=utente&passkey=utente&to=39XXXXXXXXXX&text=testo%20messaggio
OUTPUT DELLA CHIAMATA IN FORMATO JSON
stdClass Object
(
[data] => Array
(
[0] => stdClass Object
(
[status] => OK
[error] => 0
[smslog_id] => 5496
[queue] => b09035435513302c1beb6a29224c9976
[to] => 39XXXXXXXX
)
)
[error_string] =>
[timestamp] => 1413318506
)
Come si può vedere nell'esempio il tracciato riporta:
## Codici di Errore
Below table listed return coded after unsuccessful call to a webservices operation. Successful operation will returns an OK data in the response message.
Please note that by default the response message is a JSON encoded message.
| Error code | Description | |
|---|---|---|
| ERR 100 | authentication failed | |
| ERR 101 | type of action is invalid or unknown | |
| ERR 102 | one or more field empty | |
| ERR 103 | not enough credit for this operation | |
| ERR 104 | webservice token is not available | |
| ERR 105 | webservice token not enable for this user | |
| ERR 106 | webservice token not allowed from this IP address | |
| ERR 200 | send message failed | |
| ERR 201 | destination number or message is empty | |
| ERR 400 | no delivery status available | |
| ERR 401 | no delivery status retrieved and SMS still in queue | |
| ERR 402 | no delivery status retrieved and SMS has been processed from queue | |
| ERR 501 | no data returned or result is empty | |
| ERR 600 | admin level authentication failed | |
| ERR 601 | inject message failed | |
| ERR 602 | sender id or message is empty | |
| ERR 603 | account addition failed due to missing data | |
| ERR 604 | fail to add account | |
| ERR 605 | account removal failed due to unknown username | |
| ERR 606 | fail to remove account | |
| ERR 607 | set parent failed due to unknown username | |
| ERR 608 | fail to set parent | |
| ERR 609 | get parent failed due to unknown username | |
| ERR 610 | fail to get parent | |
| ERR 611 | account ban failed due to unknown username | |
| ERR 612 | fail to ban account | |
| ERR 613 | account unban failed due to unknown username | |
| ERR 614 | fail to unban account | |
| ERR 615 | editing account preferences failed due to missing data | |
| ERR 616 | fail to edit account preferences | |
| ERR 617 | editing account configuration failed due to missing data | |
| ERR 618 | fail to edit account configuration | |
| ERR 619 | viewing credit failed due to missing data | |
| ERR 620 | fail to view credit | |
| ERR 621 | adding credit failed due to missing data | |
| ERR 622 | fail to add credit | |
| ERR 623 | deducting credit failed due to missing data | |
| ERR 624 | fail to deduct credit |