Versions Compared

Key

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

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

Use this resource to create new site in the openSpecimen application. Use HTTP POST method to call this API by passing the below details in JSONformatJSON format.

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

Parameter
Details
nameName of the physical location.coordinatorCollection
instituteNameName of the institute which site is belongs to
coordinators

Collection of user info object. UserInfo User Info contains Login Name and Domain Name

type

Function of the site. It could be collection, storing, experimentation or it could be unspecified

{ collection site,repository,laboratory,not specified }

activityStatus

Defines the status of a site record

{active, closed, pending, disabled}

streetName of street to which the site belongs.
cityName of city to which the site belongs.
state [optional]Name of the state to which the site belongs 
countryName of the country to which the site belongs
zipCodeZip Code of location
faxNumber [optional]Fax number of the site
phoneNumber [optional]Phone number addressAddress of the site

 

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

Use this URL to add site in openSpecimen application.

...

{

name"Pune"
coordinatorCollection
[{ 
      loginName"admin@admin.com"
domainName"catissue"
}]
id6
type"repository"
emailAddress:"admin@admin.com"
activityStatus"Active"
emailAddressadmin@admin.com
street"SB Road"
city"Pune"
state"Maharashtra"
country"India"
zipCode"412312"
faxNumber"123321"
phoneNumber"213434324"
URLhttp://<host>:<port>/openspecimen/rest/ng/sites
MethodPOST
Requestapplication/json
json{

"name" : "Pune",

"coordinatorCollection" : [ { "loginName" : "admin@admin.com", "domainName" :"catissue"}],

"type" : "repository",

"emailAddress" : "admin@admin.com",

"activityStatus" : "Active",

"street" : "SB Road",

"city" : "Pune",

"state" : "Maharashtra",

"country" : "India" ,

"zipCode" : "412312",

"faxNumber" : "123321",

"phoneNumber" : "213434324"

}

Response

Code Block
languagejs
themeEclipse
linenumberstrue
{
    "name": "Arkansas Hospital",
    "instituteName": "A1 - For Demo Users",
    "type": "Collection Site",
    "activityStatus": "Active",
    "coordinators":
    [
        {
            "loginName": "aalfortish",
            "domain": "openspecimen"
        },
        {
            "loginName": "vinod",
            "domain": "openspecimen"
        }
    ],
    "address": "Arkansas"
}

Response

Code Block
languagejs
themeEclipse
linenumberstrue
{
    "id": 4,
    "name": "Arkansas Hospital",
    "instituteName": "A1 - For Demo Users",
    "type": "Collection Site",
    "activityStatus": "Active",
    "cpCount": 0,
    "coordinators":
    [
        {
            "id": 107,
            "firstName": "Alexandra",
            "lastName": "Alfortish",
            "loginName": "aalfortish",
            "domain": "openspecimen",
            "emailAddress": "aalfortish@lcrc.info",
            "admin": false,
            "cpCount": 0,
            "creationDate": 1438021800000
        },
        {
            "id": 14,
            "firstName": "Vinod",
            "lastName": "Gaikwad",
            "loginName": "vinod",
            "domain": "openspecimen",
            "emailAddress": "vinod.gaikwad@domain.com",
            "admin": false,
            "cpCount": 0,
            "creationDate": null
        }
    ],
    "address": "Arkansas",
}

 

Error Cases :

code
Applies to
Status Message
200All resourcesSite has been created successfully
400All requestsInvalid parameters, e.g  duplicate Site Name, blank Site Name, blank Site Type etc
401All requestsAuthorization failed, User user doesn't have Authority
500All requestsInternal server error, Encountered server error while performing operations