SMS Alert

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 
{
    "status": "success",
    "description": {
        "id": "19774",
        "username": "shanky005",
        "firstname": "Cozy",
        "lastname": "Vision",
        "mobilenumber": "8010551055",
        "emailid": "support@cozyvision.com",
        "allowedprefix": "[\"91\"]",
        "parent_id": "32",
        "expirydate": "2020-12-04",
        "mobile_verified": 1,
        "kyc_status": 1,
        "android_push": 1,
        "two_factor_auth": 0
    }
}

Example Response

401 – Unauthorized 
{
    "status": "error",
    "description": "account expired."
}

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 
{
    "status": "success",
    "description": "added successfully."
}

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 
{
    "msg": "Password reset link has been sent to your email address. You have 24 hours to complete the request.",
    "status": "success"
}

Example Response

200 – OK 
{
    "msg": "Sorry, the username entered was not found.",
    "status": "failed"
}

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 
{
    "status": "success",
    "description": "Password Changed Successfully"
}

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 
{
    "status": "success",
    "description": "Profile Updated Successfully"
}