| idtoken |
Yes |
This is your identity token, derived from your openID obtained in signup process. Do not change this value when send SMS. Please keep it private. You may view/change it on your profile page. |
| phoneNumber |
Yes |
Target phone number to send SMS to. USA & Canada: 10 digits or 11 digits starts with 1. Other countries: 10-19 digits. |
| text |
Yes |
The message itself. Must be less than 160 characters. URL-encoded if sent as GET parameter. |
| 200 |
OK |
{"ok":true,"data":{"code":0}} |
Status OK does not mean the the SMS reached the target phone number, but means the SMS reached GV. It may not be delivered by GV due to invalid phone number. In this case, you will receive a SMS on your inbound API that says "Error: this message was not successfully delivered".
|
| -1 |
Unsecure protocal. Require HTTPS. |
Unsecure protocal. Require HTTPS. |
|
| -3 |
Invalid phoneNumber. USA & Canada: 10 digits or 11 digits starts with 1. Other countries: 10-19 digits. |
Invalid phoneNumber. USA & Canada: 10 digits or 11 digits starts with 1. Other countries: 10-19 digits. |
|
| -4 |
Invalid text. Maximum length is 160. |
Invalid text. Maximum length is 160. |
|
| -6 |
Exceeded daily limit |
{"ok":false,"data":{"code":58}} |
GVSMS puts limit of 20 on trial account, and Google puts 100 on GVA. To increase daily quota, please subscribe and add more GVAs.
|
| -7 |
Flooding Error |
{"ok":false,"data":{"code":58}} |
Google does not allow user to send more than 5 texts per account at a time. To reduce or avoid flooding error, please subscribe and add more GVAs.
|
|
https://www.gvsms.com/send.do?idtoken=werkjwhweirwfsnfsfvnosil&phoneNumber=4203456778&text=Hello%20my%20friend
|
Copy above URL to browser location bar, you will see a response body saying "Invalid idtoken". This is because the idtoken does not exist. To obtain a valid one, You need to sign up for an account. |
|
You call outbound API again.
|
