Partner Management Service APIs
This section details about the service API in the Partner Management module.
For securely accessing any API in MOSIP, you must gain authentication token from kernel authentication manager.
Authenticate through client-id/Secret or User Id/Password having respective roles assigned in IAM.
After successful authentication access token will set as Authorization cookies.
Access API through postman by passing the access token in cookies.
MOSIP common authentication and authorization APIs would be used for authentication and generation of secured authentication token.
After hitting the API, you will get the authorization token in the cookie.
Prerequisite for Partner Management Module
Digital certificate sharing between MOSIP and Partners
MISP (MOSIP Infrastructure Service Provider) Creation
Master data related to Partner Management - like Policy Groups, Partner Manager mappings to Policy Groups, Policy Manager mappings to Policy Groups, Master policy for the country
Partner Management APIs
Partner Management APIs are categorized into following services
MISP Management Service This service would be used by MOSIP Admin for management of MISP(MOSIP Infrastructure Service Provider), management of MISP license keys issued to MISP, activation and deactivation of MISP and MISP license keys, getting details about MISP and MISP license keys
Policy Management Service This service would be used by Policy Manager for management of Policies. Policy manager would be able to create, update and get policy details.
Partner Management Service This service would be used by Partner Manager for management of partner requests. Partners belonging to specific policy group would be able to raise request for issuance of Partner API Keys. Partner Manager would be able to approve OR reject such partner requests. Before approving the partner request for API keys, partner manager would review the request, generate partner API key and map the API key with the policy(ies). By using this service, partner manager would be able to view partner details for given partner API Key, along with the policy mapping for the API key, and its status (active/deactive)
Partner Service This service enables partners to do self registration, submit request for respective authentication policies available for the policy group, sharing of digital certificate for secure communication helping individual authentication through partners.
MISP Management Service
This service would be used by MOSIP admin for MISP(MOSIP Infrastructure Service Provider) management.
POST /misps
MOSIP Admin would be able to create MISP using this API. At the time of creation of MISP, MISP ID is generated and shared back in response. Post successful MISP creation, by default MISP is set to active status.Kernel ID generator API would be used to generate unique id as mentioned in Kernel ID Generator.
Resource URL
https://{base_url}/partnermanagement/v1/misps
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.create |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-07-02T05:23:08.019Z |
request | Yes | Request for the application | |
request.organizationName | Yes | MISP organization name | telecom |
request.contactNumber | Optional | MISP contact number | 9876998888 |
request.emailId | Yes | MISP emailId | prm@telecom.com |
request.address | Yes | MISP address | India |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: MISP successfully created
Failure Response
Status code: 200
Description: MISP already registered
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_003 | A MISP is already registered with name - organizationName | If MISP is already registered with organizationName |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PATCH /misps/{mispId}/status
This API would be used to approve or reject the MISP.Post successful MISP approval, MISP License key is generated and set to active status.MISP License key is configurable and set to expire in 3 months, 6 months OR any configurable period.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}/status
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.update |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-07-02T05:23:08.019Z |
request | Yes | Request for the application | |
request.mispStatus | Yes | MISP Status | Approved or Rejected |
Request
Responses
Success Response
Status code: 200
Failure Response
Status code: 200
Description: MISP ID does not exist
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_004 | No information provided for update | No information provided for update |
PMS_MSP_005 | MISP ID does not exist | MISP ID not available in database |
PMS_COR_003 | Could not process the request | Any Internal Error |
PUT /misps/{mispId}
This API would be used to update MISP for given mispID.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.update |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-07-02T05:23:08.019Z |
request | Yes | Request for the application | |
request.organizationName | Optional | MISP organization name | telecom |
request.contactNumber | Optional | MISP contact number | 9876998888 |
request.emailId | Optional | MISP emailId | prm@telecom.com |
request.address | Optional | MISP address | India |
Request
Responses
Success Response
Status code: 200
Failure Response
Status code: 200
Description: MISP Organization Name, MISP Contact Number, MISP Email ID, MISP Address - None available in request
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_004 | No information provided for update | No information provided for update |
PMS_MSP_005 | MISP ID does not exist | MISP ID not available in database |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PATCH /misps/{mispId}/licenseKey
This API would be used for validating MISPs license key.
Validate license key pattern.
Validate license key is associated with the requested MISP id.
Validate license key is Active or not.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}/licenseKey
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.license.validate |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-05-20T09:48:43.394Z |
request | Yes | Request for the application | |
request.mispLicenseKey | Yes | MISP license key | fa604-affcd-33201-04234 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: MISP License validated successfully
Failure Response
Status code: 200
Description: MISP ID/MISP License Key not available in database
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_006 | MISP ID/MISP License Key does not exist | MISP ID/MISP License Key not available in database |
PMS_MSP_007 | MISP License key not associated to MISP ID | MISP License key not associated to MISP in the input |
PMS_MSP_008 | MISP License key not valid | MISP License key not valid |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PATCH /misps/{mispId}
This API would be used to update MISP status for given MISP ID.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.status.update |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-07-02T05:23:08.019Z |
request | Yes | Request for the application | |
request.mispStatus | Yes | MISP status | De-Active |
Request
Responses
Success Response
Status code: 200
Failure Response
Status code: 200
Description: MISP Organization Name, MISP Contact Number, MISP Email ID, MISP Address - None available in request
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_004 | No information provided for update | No information provided for update |
PMS_MSP_005 | MISP ID does not exist | MISP ID not available in database |
PMS_MSP_009 | Failed to update MISP status | Failed to update the MISP status |
PMS_MSP_010 | MISP status already in the requested status | MISP status already in the requested status |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PUT /misps/{mispId}/licenseKey
This API would be used to activate/deactivate MISPs License Key for the MSIP ID.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}/licenseKey
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.misp.license.update |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.mispStatus | Optional | MISP status | Active |
request.mispLicenseKey | Optional | MISP license Key | fa604-affcd-33201-04770 |
request.mispLicenseKeyStatus | Optional | MISP license Key Status | Active |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: MISP License updated successfully
Failure Response
Status code: 200
Description: MISP status, MISP License key status - None available in request
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_004 | No information provided for update | No information provided for update |
PMS_MSP_006 | MISP ID/MISP License Key does not exist | MISP ID/MISP License Key not available in database |
PMS_MSP_007 | MISP License key not associated to MISP ID | MISP License key not associated to MISP in the input |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
GET /misps
This API would be used to retrieve all MISPs details.
Resource URL
https://{base_url}/partnermanagement/v1/misps
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Responses
Success Response
Status code: 200
Failure Response
Status code: 200
Description: No MISP details found
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_012 | No MISP details found | No MISP details found |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
GET /misps/mispId/{mispId}
This API would be used to retrieve the MISPs details based on given misp id.
Resource URL
https://{base_url}/partnermanagement/v1/misps/mispId/{mispId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Responses
Success Response
Status code: 200
Failure Response
Status code: 200
Description: MISP ID does not exist
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_005 | MISP ID does not exist | MISP ID not available in database |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
GET /misps/name/{mispOrgName}
This API would be used to retrieve MISPs details based on given name
If MISP organization name present, then retrieve all misp details for matching organization name.
If MISP organization name not present, then retrieve all misp details.
Resource URL
https://{base_url}/partnermanagement/v1/misps/name/{mispOrgName}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispOrgName | Yes | MISP organization name | telecome |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Responses
Success Response
Status code: 200
Description: Config parameter retrieved successfully
Failure Response
Status code: 200
Description: No MISP found for the organization
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_011 | No MISP found for the organization | No MISP found for the organization |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
GET /misps/{mispId}/licenseKey
This API would be used by MISP Admin / MOSIP Admin for download MISPs license key. In case where license key got expired then user would be able to get a new license key. New license key thus generated would be mapped with given MISP ID . Older license keys would be updated with inactive status.
Resource URL
https://{base_url}/partnermanagement/v1/misps/{mispId}/licenseKey
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
mispId | Yes | id of the misp | 64269837502851 |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Responses
Success Response
Status code: 200
Description: MISP License retrieved successfully
Failure Response
Status code: 200
Description: MISP status, MISP License key status - None available in request
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_MSP_001 | MOSIP Admin does not exist | Unauthorized MOSIP Admin- UserName not available in database |
PMS_MSP_002 | Mismatch of the MOSIP Admin Credentials | User Name and Password of the Admin does not match |
PMS_MSP_006 | MISP ID/MISP License Key does not exist | MISP ID/MISP License Key not available in database |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
Policy Management Service
This service would be used by Policy Manager to manage policies for his Policy Group.
POST /policies
This API would be used to create new Policy for policy group
Resource URL
https://{base_url}/partnermanagement/v1/policies
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.policy.create |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.name | Yes | name of the policy | Insurance Policy |
request.desc | Yes | description of the policy | Desc about policy |
request.policies | Yes | policy file | JSON |
request.policies.authPolicies | Yes | auth details | Array of JSON |
request.policies.allowedKycAttributes | Yes | eKYC details | Array of JSON |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: create new Policy for policy group is successful
Failure Response
Status code: 200
Description: If policy name already exists in the policy group
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_POL_001 | Policy Manager does not exist | If Policy Manager does not exist |
PMS_POL_002 | Mismatch of Policy Manager Credentials | If any mismatch of Policy Manager Credentials |
PMS_POL_004 | Policy Name already exists in the policy Group | If Policy Name already exists in the policy Group |
PMS_POL_005 | Unsupported KYC attribute in the Policy File | If any unsupported KYC attribute in the Policy File |
PMS_POL_006 | Unsupported Authentication Type in the Policy File | If any unsupported Authentication Type in the Policy File |
PMS_POL_007 | eKYC attribute missing in the policy file | If any eKYC attribute missing in the policy file |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PUT /policies/{policyID}
This API would be used to update existing policy for a policy group
Resource URL
https://{base_url}/partnermanagement/v1/policies/{policyID}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
policyID | Yes | policyID | 45678451034176 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.policy.update |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.name | Yes | name of the policy | Insurance Policy |
request.desc | Yes | description of the policy | Desc about policy |
request.policies | Yes | policy file | JSON |
request.policies.authPolicies | Yes | auth details | Array of JSON |
request.policies.allowedKycAttributes | Yes | eKYC details | Array of JSON |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: update existing policy for policy group is successful
Failure Response
Status code: 200
Description: If policy ID does not exist
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_POL_001 | Policy Manager does not exist | If Policy Manager does not exist |
PMS_POL_002 | Mismatch of Policy Manager Credentials | If any mismatch of Policy Manager Credentials |
PMS_POL_004 | Policy Name already exists in the policy Group | If Policy Name already exists in the policy Group |
PMS_POL_005 | Unsupported KYC attribute in the Policy File | If any unsupported KYC attribute in the Policy File |
PMS_POL_006 | Unsupported Authentication Type in the Policy File | If any unsupported Authentication Type in the Policy File |
PMS_POL_007 | eKYC attribute missing in the policy file | If any eKYC attribute missing in the policy file |
PMS_POL_008 | Policy ID does not exist | If Policy ID does not exist |
PMS_POL_009 | No information provided for update | if no information provided for update |
PMS_POL_010 | Policy Manager is denied permission to update the policy | if the policy manager is denied permission to update the policy |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
PATCH /policies/{policyID}
This API would be used to update the status (activate/deactivate) for the given policy id.
Resource URL
https://{base_url}/partnermanagement/v1/policies/{policyID}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
policyID | Yes | policyID | 45678451034176 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.partnermanagement.policy.update.status |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.status | Yes | status of the policy that needs to update | De-Active |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Request
Responses
Success Response
Status code: 200
Description: update the existing policy status successful
Failure Response
Status code: 200
Description: If policy ID does not exist
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PMS_POL_001 | Policy Manager does not exist | If Policy Manager does not exist |
PMS_POL_002 | Mismatch of Policy Manager Credentials | If any mismatch of Policy Manager Credentials |
PMS_POL_004 | Policy Name already exists in the policy Group | If Policy Name already exists in the policy Group |
PMS_POL_008 | Policy ID does not exist | If Policy ID does not exist |
PMS_POL_012 | Policy Manager is denied permission to update the policy status | if the policy manager is denied permission to update the policy status |
PMS_COR_001 | Missing Input Parameter - %d | Missing Input Parameter - for all mandatory attributes |
PMS_COR_002 | Invalid Input Parameter - %d | Invalid Input Parameter - for all attributes not as per defined data definition |
PMS_COR_003 | Could not process the request | Any Internal Error |
GET /policies
Policy manager would require this service to get details for the policies in the policy group he belongs to. All the policy groups are required to be back filled in the partner management database through an offline process based on country specific requirements. Partner Manager and Policy Manager assigned for the Policy group are also required to be back filled along with creation of the policy group. Partner management would depend on Kernel IAM module services for all user management related activities. User ID and Password are shared using off-line process.
Resource URL
https://{base_url}/partnermanagement/v1/policies
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Header
Name | Required | Description | Comment |
---|---|---|---|
Authorization | Yes | authentication token | Mosip-TokeneyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJyYXZpLmJhbGFqaUBtaW5kdHJlZS5jb20iLCJtb2JpbGUiOiIiLCJtYWlsIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwicm9sZSI6IklORElWSURVQUwiLCJuYW1lIjoicmF2aS5iYWxhamlAbWluZHRyZWUuY29tIiwiaXNPdHBSZXF1aXJlZCI6dHJ1ZSwiaXNPdHBWZXJpZmllZCI6dHJ1ZSwiaWF0IjoxNTYyNTgwMzg0LCJleHAiOjE1NjI1ODYzODR9.eycrDnzPFBnx57wp6v-iXHtFnRxPgOysG3QETnElSswBUH5ojUUCLsn6SeYukIy-rEZ0SOdr9jkLE6A8tNkj4w |
Responses
Success Response
Status code: 200
Description: retrieve the policies available for my policy group successful