Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

openspecimen/rest/ng/institutes

Use this resource to create new institute in the openspecimen application. Use HTTP POST method to call this API by passing the below details in JSON format.

Below are the attributes which need to be sent in the request body:

Parameter
Details
nameInstitute Name. It should be unique in application
departments

It is a collection of departments:

name: name of department


http[s]:<host>:<port>/openspecimen/rest/ng/institutes

Use this URL to add institute in openspecimen application.

Result:

The response of this request will contains the details of the created institutes.

Below is the example of the create institute:

URLhttp://<host>:<port>/openspecimen/rest/ng/institutes
MethodPOST
Requestapplication/json
json


Code Block
languagejs
themeEclipse
linenumberstrue
{
    "name": "Bocabio"
}


Response


Code Block
languagejfx
themeEclipse
linenumberstrue
{
    "id": 3,
    "name": "Bocabio1",
    "activityStatus": "Active",
    "departmentsCount": 0,
    "usersCount": 0,
 }


 Error Cases :

code
Applies to
Status Message
200All resourcesInstitute has been created successfully
400All requestsInvalid parameters, e.g  duplicate institute name, blank institute name etc
401All requestsAuthorization failed, user doesn’t have authority
500All requestsInternal server error, encountered server error while performing operations