System Settings

PreviousBulk Upload NextAPI Management Service

Last updated 2 years ago

Was this helpful?

set

post

/data/v1/system/settings/set

Authorizations

Header parameters

tsstring

Timestamp at which given API request is sent.

X-msgidstring

This ID uniquely identifies a request if the same API is executed multiple times.

Authorizationstringrequired

To make use of any System API, you require authorization. Raise a request to the administrator for the use of the API. You will receive the authorization key. Specify the key received, here.

x-authenticated-user-tokenstringrequired

It is a unique token/key to authenticate the user each time an API is called. For corresponding sessions this token is used, not your actual username/password

x-authenticated-forstring

Managed User token of registered MUA user performing given API request.

Body

requestRequestrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://staging.sunbirded.org/api/data/v1/system/settings/set' \
  --header 'Authorization: text' \
  --header 'x-authenticated-user-token: text' \
  --header 'Content-Type: application/json' \
  --data '{"request":{"id":"userTnc","field":"userTnc","value":"{\"latestVersion\":\"3.5.0\"}"}}'

200

400

401

500

{
  "id": "api.system.settings.set",
  "ver": "v1",
  "ts": "2020-12-01 10:47:16:629+0000",
  "responseCode": "OK",
  "params": {
    "resmsgid": null,
    "msgid": "340d4ef3f113f5db5e81859e18663214",
    "err": null,
    "status": "success",
    "errmsg": null
  },
  "result": {
    "response": "SUCCESS",
    "id": "userTnc"
  }
}

Success Response

get

/data/v1/system/settings/get/{configName}

Authorizations

Path parameters

configNamestringrequired

Field config Name

Example: userTnc

Header parameters

tsstring

Timestamp at which given API request is sent.

X-msgidstring

This ID uniquely identifies a request if the same API is executed multiple times.

Authorizationstringrequired

To make use of any System API, you require authorization. Raise a request to the administrator for the use of the API. You will receive the authorization key. Specify the key received, here.

x-authenticated-user-tokenstring

It is a unique token/key to authenticate the user each time an API is called. For corresponding sessions this token is used, not your actual username/password

x-authenticated-forstring

Managed User token of registered MUA user performing given API request.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://staging.sunbirded.org/api/data/v1/system/settings/get/{configName}' \
  --header 'Authorization: text'

200

401

404

500

{
  "id": "api.system.settings.get.userTnc",
  "ver": "v1",
  "ts": "2020-12-01 17:46:36:645+0530",
  "responseCode": "OK",
  "params": {
    "resmsgid": null,
    "msgid": "62c78ba7-b0e1-408d-8dfe-7cc3c4e652cc",
    "err": null,
    "status": "success",
    "errmsg": null
  },
  "result": {
    "response": {
      "id": "userTnc",
      "field": "userTnc",
      "value": "{\"latestVersion\":\"3.4.0\"}"
    }
  }
}

Success Response

list

get

/data/v1/system/settings/list

Authorizations

Header parameters

tsstring

Timestamp at which given API request is sent.

X-msgidstring

This ID uniquely identifies a request if the same API is executed multiple times.

Authorizationstringrequired

To make use of any System API, you require authorization. Raise a request to the administrator for the use of the API. You will receive the authorization key. Specify the key received, here.

x-authenticated-user-tokenstring

It is a unique token/key to authenticate the user each time an API is called. For corresponding sessions this token is used, not your actual username/password

x-authenticated-forstring

Managed User token of registered MUA user performing given API request.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://staging.sunbirded.org/api/data/v1/system/settings/list' \
  --header 'Authorization: text'

200

401

500

{
  "id": "api.system.settings.list",
  "ver": "v1",
  "ts": "2020-12-01 12:21:46:829+0000",
  "responseCode": "OK",
  "params": {
    "resmsgid": null,
    "msgid": "f11acda288889cf47ecdf8812e623387",
    "err": null,
    "status": "success",
    "errmsg": null
  },
  "result": {
    "response": [
      {
        "id": "uniqueField",
        "field": "uniqueField",
        "value": false
      },
      {
        "id": "custodianRootOrgId",
        "field": "custodianRootOrgId",
        "value": 1285019302823526400
      },
      {
        "id": "tncConfigtest",
        "field": "tncConfigtest",
        "value": "test"
      },
      {
        "id": "userTnc",
        "field": "userTnc",
        "value": "{\"latestVersion\":\"3.5.0\"}"
      },
      {
        "id": "test",
        "field": "test",
        "value": "@test"
      },
      {
        "id": "userTnc",
        "field": "userTnc",
        "value": "{\"latestVersion\":\"3.5.0\"}"
      },
      {
        "id": "channelRegStatus",
        "field": "channelRegStatus",
        "value": false
      },
      {
        "id": "phoneUnique",
        "field": "phoneUnique",
        "value": true
      },
      {
        "id": "systemInitialisationStatus",
        "field": "systemInitialisationStatus",
        "value": "CUSTODIAN_ORG_CREATED"
      },
      {
        "id": "courseFrameworkId",
        "field": "courseFrameworkId",
        "value": "tpd"
      },
      {
        "id": "consumptionFaqs",
        "field": "consumptionFaqs",
        "value": "https://dev.sunbirded.org/faq.html"
      },
      {
        "id": "ssoCourseSection",
        "field": "ssoCourseSection",
        "value": 129795520637419520
      },
      {
        "id": "emailUnique",
        "field": "emailUnique",
        "value": true
      },
      {
        "id": "tn",
        "field": "tn",
        "value": "{'helpdeskEmail':'abc@abc.com','playstoreLink':'play.google.com/appid=123'}"
      },
      {
        "id": "emailUniqueAndPhone",
        "field": "emailUniqueAndPhone",
        "value": true
      }
    ]
  }
}

Success Response