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 |