API documentation

    Compound Registration provides a REST interface to interact with the registration system.

    Documentation

    If you have an installed Compound Registration version, you can check the API documentation at:

    https://yourhost.com/RegistryCxn/rest/swagger-ui.html

    In case you don't have a deployed system, you can check the API doc of the latest Compound Registration version on the compreg-demo-swagger-ui. Authentication is needed to use the example REST API, access can be requested here.

    API authentication

    API calls return valid responses, only if the request is authenticated. One way of authentication is Basic Authentication , in this case an "Authorization" header must be added to the HTTP request.

    For example purposes let's consider the case when a client wants to retrieve a compound identified by "CXN132". In this case a GET request must be sent to

    https://yourhost.com/RegistryCxn/rest/structureService/registryStructure?id=CXN132

    To authenticate this request, the proper "Authorization" header must be added, containing the "authorization token". The authorization token is generated from the combination of the base64 encoded username and password pair.

    As an example when the username is "tom" and the password is "password" then the header can be generated

    • on linux with bash
    echo -n "tom:password" | base64
    dG9tOnBhc3N3b3Jk
    • on windows with powershell
    [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("tom:password"))
    dG9tOnBhc3N3b3Jk
    • or alternatively this web tool could be used

    The full example with "Authorization" in the request header:

    GET https://yourhost.com/RegistryCxn/rest/structureService/registryStructure?id=CXN1 HTTP/1.1
    Authorization: "Basic dG9tOnBhc3N3b3Jk"

    More examples on how to construct an API call can be seen in the payload of developer console in your browser. You can have more info here.

    Forcing compounds to the Staging

    Using the API, compounds can be prevented to be registered and "forced" into the Staging area for further review. For more details check the swagger for Autoregistration.