Map State Codes

Overview:

The Map State Code API enables the creation, retrieval, updating, and deletion of state code mappings. This documentation provides detailed information on the endpoints, request and response formats, and field descriptions.

Create:

Endpoint: /api/message/map_state_codes/{ Company }

This API will create a new map state code.

• Method: POST
• Content-Type: application/json
• Authentication: Bearer <token>

Request Body:

{
    "data_set": "<data-set>",                 //string
    "src_ccty": "<Source-Country-Code>",      //string
    "src_cste": "<Source-State-Code>",        //string
    "src_dsca": "<Source-State-Description>" //string
}

Fields Details:

Field Name	Description	Data Type	Length
data_set	Data Set	String	10
src_ccty	Source Country Code	String	3
src_cste	Source State Code	String	3
src_dsca	Source State Description	String	120

---

Response Body: (Status: 200)

{
    "data_set": "<data-set>", 
    "src_ccty": "<Source-Country-Code>",
    "src_cste": "<Source-State-Code>",
    "src_dsca": "<Source-State-Description>"
}

Field Details:

Field Name	Description	Data Type	Example
data_set	Data Set	String	"Dataset1"
src_ccty	Source Country Code	String	"IND"
src_cste	Source State Code	String	"02"
src_dsca	Source State Description	String	"KUL"

---

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token / invalid token passed or When Normal user tries to create a new record :

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad Request/ Duplicate)

When the record is already present in the database:

{
    "message": "Record already exists!"
}

Response Body: (Status: 400 - Bad Request/ Invalid Payload)

When passing invalid data to state code:

{
    "message": "Reference Error: State Code"
}

Response Body: (Status: 400 - Bad Request/ Invalid Payload)

When passing invalid data to country code:

{
    "message": "Reference Error: Country Code."
}

Response Body: (Status: 400 - Bad Request/ Invalid Datatype)

When passing a record with invalid datatype:

{
    "message": "Invalid Data Type"
}

Response Body: (Status: 500 - Internal Server Error/ Empty Field)

When passing an empty field as input to the source country code:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'src_ccty'"
}

When passing an empty field as input to the source state code:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'src_cste'"
}

when passing an empty field as input to dataset:

 {
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'data_set'"
}

Update:

Endpoint: /api/message/map_state_codes/{ Company }

This API will update the specified map state code.

• Method: PUT
• Content-Type: application/json
• Authentication: Bearer <token>

Request Body:

{
    "data_set": "<data-set>",                   //string
    "src_ccty": "<Source-Country-Code>",        //string
    "src_cste": "<Source-State-Code>",          //string
    "src_dsca": "<Source-State-Description>"   //string
}

Response Body: (Status: 200)

{
    "data_set": "<data-set>",  
    "src_ccty": "<Source-Country-Code>",
    "src_cste": "<Source-State-Code>",
    "src_dsca": "<Source-State-Description>"
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token /invalid token passed or When Normal User tries to update the record:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad request/ Not Found)

When the specified record is not found:

{
    "message": "Record not found!"
}

Response Body: (Status: 400 - Bad Request/ Invalid Payload)

When passing invalid data to state code:

{
    "message": "Reference Error: State Code"
}

Response Body: (Status: 400 - Bad Request/ Invalid Payload)

When passing invalid data to country code:

{
    "message": "Reference Error: Country Code."
}

Response Body: (Status: 400 - Bad Request/ Invalid Datatype)

When passing a record with invalid datatype:

{
    "message": "Invalid Data Type"
}

Response Body: (Status: 500 - Internal Server Error/ Empty Field)

When passing an empty field as input to the source country code:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'src_ccty'"
}

When passing an empty field as input to the source state code:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'src_cste'"
}

when passing an empty field as input to dataset:

 {
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'data_set'"
}

Delete:

Endpoint: /api/message/map_state_codes/{ Company }/{ record_id }

This API will delete the specified record id.

• Method: DELETE
• Authentication: Bearer <token>

Response Body: (Status: 200)

{
    "Message": "Message Deleted Sucessfully!"
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token / invalid token passed or When Normal user tries to delete the existing record:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 500 - Internal Server Error / Invalid Record)

When there is no record or invalid record passed:

{
    "Message": "Unable to Delete Record - Invalid Data Type"
}

Get:

Endpoint: /api/message/map_state_codes/{ Company }/{ record_id }

This API retrieves the specified record id.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

{
    "data_set": "<data-set>",  
    "ccty_dsca": "<Country-Description>",
    "dsca": "<State-Description>",
    "src_ccty": "<Source-Country-Code>",
    "src_cste": "<Source-State-Code>",
    "src_dsca": "<Source-State-Description>"
}

Response Body: (Status: 200 - success status /invalid id)

When there is no such id or invalid id is passed :

{
    "message": "null"
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token or invalid token passed :

{
    "message": "Unauthorized!"
}

Get All:

Endpoint: /api/messages/map_state_codes/{ Company }/{ PageSize }/{ PageNumber }

This API retrieves all records.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

[
    {
        "data_set": "<data-set>",  
        "ccty_dsca": "<Country-Description>",
        "dsca": "<State-Description>",
        "src_ccty": "<Source-Country-Code>",
        "src_cste": "<Source-State-Code>",
        "src_dsca": "<Source-State-Description>"
    }
]

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token or invalid token passed :

{
    "message": "Unauthorized!"
}