BlacklistedWords APIs

This section details about the service APIs for the BlacklistedWords

BlacklistedWords Master API

POST /blacklistedwords

This service will create a blacklisted word which will be used in the MOSIP platform.

Resource URL

POST /blacklistedwords

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description
description	optional	blacklisted word description
isActive	Yes	is active or not
langCode	Yes	language code
word	Yes	blacklisted word name

Name

Required

Description

Default Value

Example

description

optional

blacklisted word description

isActive

Yes

is active or not

langCode

Yes

language code

word

Yes

blacklisted word name

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "description": "string",
    "isActive": true,
    "langCode": "string",
    "word": "string"
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "langCode": "string",
    "word": "string"
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

PUT /blacklistedwords

This service will update the blacklisted word which is used in the MOSIP platform.

Resource URL

PUT /blacklistedwords

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description
description	optional	blacklisted word description
isActive	Yes	is active or not
langCode	Yes	language code
oldWord	Yes	old blacklisted word
word	Yes	blacklisted word

Name

Required

Description

Default Value

Example

description

optional

blacklisted word description

isActive

Yes

is active or not

langCode

Yes

language code

oldWord

Yes

old blacklisted word

word

Yes

blacklisted word

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "description": "string",
    "isActive": true,
    "langCode": "string",
    "oldWord": "string",
    "word": "string"
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "langCode": "string",
    "word": "string"
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

GET /blacklistedwords/{langcode}

This service will provides the service for the List of blacklisted words based on the passed language code.

Resource URL

GET /blacklistedwords/{langcode}

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value	Example
langcode	Yes	language code

Name

Required

Description

Default Value

Example

langcode

Yes

language code

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "blacklistedwords": [
      {
        "description": "string",
        "isActive": true,
        "langCode": "string",
        "word": "string"
      }
    ]
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

DELETE /blacklistedwords/{word}

This service will provides the service to delete the blacklisted word.

Resource URL

DELETE /blacklistedwords/{word}

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value	Example
word	Yes	blacklisted word to be deleted

Name

Required

Description

Default Value

Example

word

Yes

blacklisted word to be deleted

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "code": "string"
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

GET /blacklistedwords/all

This service will provides the service for the List of blacklistedwords.

Resource URL

GET /blacklistedwords/all

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value
orderBy	optional	response order	desc
pageNumber	optional	page no for the requested data	0
pageSize	optional	page size for the requested data	10
sortBy	optional	sort the requested data based on param value	createdDateTime

Name

Required

Description

Default Value

Example

orderBy

optional

response order

desc

pageNumber

optional

page no for the requested data

pageSize

optional

page size for the requested data

sortBy

optional

sort the requested data based on param value

createdDateTime

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "data": [
      {
        "createdBy": "string",
        "description": "string",
        "isActive": true,
        "isDeleted": true,
        "langCode": "string",
        "updatedBy": "string",
        "word": "string"
      }
    ],
    "pageNo": 0,
    "totalItems": 0,
    "totalPages": 0
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

PUT /blacklistedwords/details

This service will update the blacklisted word details except the word itself.

Resource URL

PUT /blacklistedwords/details

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description
description	optional	blacklisted word description
isActive	Yes	is active or not
langCode	Yes	language code
word	Yes	blacklisted word name

Name

Required

Description

Default Value

Example

description

optional

blacklisted word description

isActive

Yes

is active or not

langCode

Yes

language code

word

Yes

blacklisted word name

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "description": "string",
    "isActive": true,
    "langCode": "string",
    "word": "string"
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "langCode": "string",
    "word": "string"
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

POST /blacklistedwords/words

This service will return "Invalid" when the word is a blacklisted word and retrun "valid" when the word is not a blacklist word.

Resource URL

POST /blacklistedwords/words

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value	Example
blacklisted words	Yes	blacklisted words to be validated

Name

Required

Description

Default Value

Example

blacklisted words

Yes

blacklisted words to be validated

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "blacklistedwords": [
      "string"
    ]
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "id": "string",
  "version": "string",
  "responsetime": "2019-11-15T08:04:42.310Z",
  "metadata": null,
  "response": {
    "code": "Valid"
  },
  "errors": null
}

Response code: 200 Ok

Failure details

Error Code	Error Message	Error Description
KER-MSD-007	Error occurred while fetching Blacklisted words	Fetch Issue
KER-MSD-008	Blacklisted word not found	Data Not Found
KER-MSD-070	Error occurred while inserting Blacklisted words	Insertion Issue
KER-MSD-105	Error occurred while updating Blacklisted Word	Update Issue
KER-MSD-106	Error occurred while deleting Blacklisted Word	Deletion Issue

Error Code

Error Message

Error Description

KER-MSD-007

Error occurred while fetching Blacklisted words

Fetch Issue

KER-MSD-008

Blacklisted word not found

Data Not Found

KER-MSD-070

Error occurred while inserting Blacklisted words

Insertion Issue

KER-MSD-105

Error occurred while updating Blacklisted Word

Update Issue

KER-MSD-106

Error occurred while deleting Blacklisted Word

Deletion Issue

POST /blacklistedwords/filtervalues

This service returns the filter values which are required in the dropdown entries of the filter screen.

Resource URL

POST /blacklistedwords/filtervalues

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value	Example
filters	No	Array of the filter applied. In case of "list" screen, this array will be empty	-NA-
columnName	No	The column name in the JSON response	-NA-
type	No	The value have to be in ["unique","all"]	unique	unique
languagecode	Yes	Language code in Language code in ISO 639-2 format

Name

Required

Description

Default Value

Example

filters

Array of the filter applied. In case of "list" screen, this array will be empty

-NA-

columnName

The column name in the JSON response

-NA-

type

The value have to be in ["unique","all"]

unique

languagecode

Yes

Language code in Language code in ISO 639-2 format

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "filters": [
      {
        "columnName": "string",
        "type": "string",
        "text": "string"
      }
    ],
    "languageCode": "string",
    "optionalFilters": [
      {
        "value": "string",
        "fromValue": "string",
        "toValue": "string",
        "columnName": "string",
        "type": "string"
      }
    ]
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "filters": [
      {
        "fieldID": "string",
        "fieldValue": "string"
      }
    ]
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

POST /blacklistedwords/search

This service is for the blacklisted words search functionality. All the filter parameters are passed and the blacklisted words are searched and the matching results are returned.

Resource URL

POST /blacklistedwords/search

Resource details

Resource Details	Description
Response format	JSON
Requires Authentication	Yes

Resource Details

Description

Response format

JSON

Requires Authentication

Yes

Parameters

Name	Required	Description	Default Value
filters	No	Array of the filter applied. In case of "list" screen, this array will be empty	-NA-
columnName	No	The column name in the JSON response	-NA-
type	No	The value have to be in ["contains","equals","startsWith","between"]	-NA-
value	No	Value or id selected in the filter by the end user	-NA-
fromValue	No	If the type is "between", this field is the value of the start range	-NA-
toValue	No	If the type is "between", this field is the value of the end range	-NA-
languagecode	Yes	Language code in Language code in ISO 639-2 format
sort	No	This is an array of the sort field and type
sortfield	The field on which the sort is applied		modifiedDate
sorttype	This should be either of ['ASC','DESC']		ASC
pagination	The pagination parameter object
pageStart	This is the start index	0	10
pageFetch	This is the amount of records to be fetched	10	10

Name

Required

Description

Default Value

Example

filters

Array of the filter applied. In case of "list" screen, this array will be empty

-NA-

columnName

The column name in the JSON response

-NA-

type

The value have to be in ["contains","equals","startsWith","between"]

-NA-

value

Value or id selected in the filter by the end user

-NA-

fromValue

If the type is "between", this field is the value of the start range

-NA-

toValue

If the type is "between", this field is the value of the end range

-NA-

languagecode

Yes

Language code in Language code in ISO 639-2 format

sort

This is an array of the sort field and type

sortfield

The field on which the sort is applied

modifiedDate

sorttype

This should be either of ['ASC','DESC']

ASC

pagination

The pagination parameter object

pageStart

This is the start index

pageFetch

This is the amount of records to be fetched

Example Request

{
  "id": "string",
  "metadata": {},
  "request": {
    "filters": [
      {
        "value": "string",
        "fromValue": "string",
        "toValue": "string",
        "columnName": "string",
        "type": "string"
      }
    ],
    "sort": [
      {
        "sortField": "string",
        "sortType": "string"
      }
    ],
    "pagination": {
      "pageStart": 0,
      "pageFetch": 0
    },
    "languageCode": "string"
  },
  "requesttime": "2018-12-10T06:12:52.994Z",
  "version": "string"
}

Example Response

{
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ],
  "id": "string",
  "metadata": {},
  "response": {
    "data": [
      {
        "createdBy": "string",
        "description": "string",
        "isActive": true,
        "isDeleted": true,
        "langCode": "string",
        "updatedBy": "string",
        "word": "string"
      }
    ],
    "fromRecord": 0,
    "toRecord": 0,
    "totalRecord": 0
  },
  "responsetime": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
  "version": "string"
}

Response code: 200 Ok

PreviousBiometric SDK APIs NextCommon APIs

Last updated 2 years ago