See BestSMS API documentation: REST API, HTTP/S API
APIs perform only simple form validation on receipt of your API call; it won't validate the content of your message, the Authorization HTTP header, or the Sender/APIKey validity when accepting the call. These are validated by our authentication engine after receiving the API call and reported to the API user's administrator as an email to the listed 'API Error Email Notify' email address (viewable in your Dashboard login). This is to achieve optimum resiliency and speed, and to provide a layer of protection against API brute force attacks.
When submitting messages to the REST API, possible failure rejection codes are:
| Result | Error Message | Description |
| Success | API submission accepted. Use a GET Poll or Webhook to track message delivery. If the message fails authentication, check your Error Email Notify email address. | |
| Failed | Error occurred while creating job | Server-side error. Try again, or contact us if the error persists. |
| Failed | Missing Sender | Empty 'Sender' field, empty Authorization header, or your API call is malformed and we can't find the 'Sender' |
| Failed | Missing APIKey | Empty 'APIKey' |
| Failed | Invalid sender format | 'Sender' is not an email address |
| Failed | Unauthorized | Your Authorization token is incorrect or missing |
| Failed | Missing message data | Empty 'MessageData' field |
| Failed | Missing or empty destinations | Target(s) not found |
| Failed | Error - Could not find any valid destination(s). | No valid targets found in the Destination section, ie. if MessageType is SMS, there is no mobile number listed as a Recipient in 'Destinations' |
| Failed | WebhookCallbackURL must start with https:// | You will need to include the full path including the https:// prefix in your custom WebhookCallbackURL value (http:// is not supported) |
| Failed | Message(s) NOT found | GET Poll is unable to find messages (result and reply tracking) |
| Failed | Missing or empty message | Empty MessageData.Message field |
© BestSMS. All Rights Reserved. Designed by HTML Codex