SMS Alert

HTTP Status Codes

SMSAlert uses standard HTTP status codes to communicate errors:

Status Code

Value

200

OK – Everything went as planned.

202

Accepted – Request accepted.

400

Bad Request – Something in your header or request body was malformed.

401

Unauthorised – Necessary credentials were either missing or invalid.

402

Payment Required – The action is not available on your plan, or you have exceeded usage limits for your current plan.

403

Your credentials are valid, but you don’t have access to the requested resource.

404

Not Found – The object you’re requesting doesn’t exist.

409

Conflict – You might be trying to update the same resource concurrently.

429

Too Many Requests – You are calling our APIs more frequently than we allow.

5xx

Server Errors – Something went wrong on our end. Please try again.

Account

POST Login / Profile

https://www.smsalert.co.in/api/user.json?apikey=5e0741771f08e

params


apikey

5e0741771f08e

API Key generated from your SMS account

Example Request


Example Response

200 – OK

Example Response

401 – Unauthorized

Account

POST Register

https://www.smsalert.co.in/users/add.json?rtype=self

Headers


Content-Type

application/x-www-form-urlencoded

params


rtype

self

Mandatory field for creating the account via api

Body urlencoded


data[User][username]

Ram2254mm

User Name

data[User][mobilenumber]

8010551055

Mobile Number

data[User][emailid]

ram@cozycision.com

Email Id

data[User][firstname]

Ram

First Name

data[User][lastname]

Kumar

Last Name

Example Request


Example Response

200 – OK

Account

POST Forgot Password

https://www.smsalert.co.in/users/forgotpassword.json

Headers


Content-Type

application/x-www-form-urlencoded

Body urlencoded


data[User][username_email]

shanky@cozyvision.com

Registered Mail Id

Example Request


Example Response

200 – OK

Example Response

200 – OK

Account

POST Change Password

https://www.smsalert.co.in/api/changepwd.json

Headers


Content-Type

application/x-www-form-urlencoded

Body urlencoded


apikey

5dd7cd37e7239

API Key generated from your SMS account

pwd

Sh@12345678

Old Password

newpwd

Sh@61257061

New Password

cnfpwd

Sh@61257061

Confirm Password

Example Request


Example Response

200 – OK

Account

POST Update Profile

https://www.smsalert.co.in/api/updateprofile.json?apikey=5e0741771f08e&firstname=Cozy&lastname=Vision&mobilenumber=8010551055&emailid=support@cozyvision.com&fcm_id=6464646

params


apikey

5e0741771f08e

API Key generated from your SMS account

firstname

Cozy

First Name

lastname

Vision

Lastname

mobilenumber

8010551055

Mobile Number

emailid

support@cozyvision.com

Email Id

fcm_id

6464646

Example Request


Example Response

200 – OK