Page Comparison

...

Parameter

Details

module

Name of the module for which you are updating the configurations.

Currently there are 2 modules:

name

Name of the property for which you want to update/add the value

server_host : Email server host, e.g smtp.google.com
server_port: Email server port, e.g 25
account_id: Email Id which will be used to send the emails, e.g. test@gmail.com
account_password: Provide password to authenticate mail server if required
starttls_enabled: Set true if required
auth_enabled: Set true if required
admin_email_id: Email id of admin, by default all emails are cc in to admin. e.g. admin@admin.com
app_url: application URL which should be sent in the emails, e.g. http://localhost:8080/openspecimen

value

The actual value of the above specified property names.

http[s]:<host>:<port>/openspecimen/rest/ng/config-settings

Use this URL to configure/update the properties

Result:

The response of this request will contains the details of the added/updated property.

Below is the example of the register authentication domain:

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "server_host", "value": "localhost" }
Response	{ "module": "email", "name": "server_host", "value": "localhost" }

2. Sets email server port

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "server_port", "value": "25" }
Response	{ "module": "email", "name": "server_port", "value": "25" }

3. Sets email account id

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "account_id", "value": "test@gmail.com" }
Response	{ "module": "email", "name": "account_id", "value": "test@gmail.com" }

4. Sets email account id

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "account_password", "value": "password" }
Response	{ "module": "email", "name": "account_password", "value": "password" }

5. Set mail.smtp.starttls.enable

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "starttls_enabled", "value": "true" }
Response	{ "module": "email", "name": "starttls_enabled", "value": "true" }

6. Set mail.smtp.auth

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "auth_enabled", "value": "true" }
Response	{ "module": "email", "name": "auth_enabled", "value": "true" }

7. Set admin email id

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "email", "name": "admin_email_id", "value": "admin@admin.com" }
Response	{ "module": "email", "name": "admin_email_id", "value": "admin@admin.com", }

5. Sets 8. Sets application url (this belongs to common module)

URL	/openspecimen/rest/ng/config-settings
Method	PUT
Request	application/json
json	{ "module": "common", "name": "app_url", "value": "http://localhost:9000" }
Response	{ "module": "common", "name": "app_url", "value": "http://localhost:9000" }

Error cases :

This section describes the response cases for register authentication API

code	Applies to	Status Message
200	All resources	Domain has been registered successfully
400	All requests	Invalid parameters, e.g blank implClass in-case of custom domain, duplicate domain name etc
401	All requests	Authorization failed, user doesn’t have authority
500	All requests	Internal server error, encountered server error while performing operations or provided wrong ldap information

...

Versions Compared