API Management Service

The API management microservice provides services to create, manage and validate API tokens to register mobile and desktop apps, and to issue and refresh API tokens of registered mobile and desktop app devices.

PreviousSystem Settings NextData Sync

Last updated 2 years ago

Was this helpful?

Get API token

This API is used to get the token.

/consumer/desktop_device/credential/register/ endpoint helps to get the token.
Required fields cannot be left null or empty

post

/api-manager/v2/consumer/desktop_device/credential/register

Header parameters

Content-Typestringrequired

The Content Type entity is the media type of the resource.Possible media types can be:-

Application/json
Multipart/form-data
Application/x-www-form-urlencoded

Authorizationstringrequired

To make use of the 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.

Body

requestRegistryObjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://staging.open-sunbird.org/api/api-manager/v2/consumer/desktop_device/credential/register' \
  --header 'Content-Type: */*' \
  --header 'Authorization: text' \
  --data '{"request":{"key":"text"}}'

200

500

{
  "id": "text",
  "ver": "text",
  "ets": 1,
  "params": {
    "resmsgid": "text",
    "msgid": "text",
    "err": "text",
    "status": "text",
    "errmsg": "text"
  },
  "result": {
    "key": "text",
    "secret": "text",
    "token": "text"
  }
}

SUCCESS. The operation was successful!

Get a new access token

This API is used to obtain a new access token

Required fields cannot be left null or empty

post

/auth/v1/refresh/token

Authorizations

Body

refresh_tokenstringrequired

Responses

application/json

text/html

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://staging.open-sunbird.org/api//auth/v1/refresh/token' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data '{"refresh_token":"text"}'

200

400

415

500

{
  "id": "api.refresh.token",
  "ver": "1.0",
  "ts": 1606816047013,
  "params": {
    "resmsgid": "abf4051d-1449-4ea6-8c56-af44faa4c86e",
    "status": "successful",
    "err": null,
    "errmsg": null
  },
  "result": {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImFjY2VzczAifQ.eyJhdWQiOiJhbmRyb2lkIiwic3ViIjoiZjo1MGY5NjdkNC1iOWRiLTQ1MjgtOTUwYy1iOWYwMzMyZTYzYmE6YTFlNjRiNDEtMTZjZC00N2Y3LTk4OWQtYTYwNWU3NDBkMDQwIiwiaXNzIjoiaHR0cHM6Ly9leGFtcGxlLm9yZy9hdXRoL3JlYWxtcy9zdW5iaXJkIiwidHlwIjoiQmVhcmVyIiwiZXhwIjoxNjA2OTI5MjA0LCJpYXQiOjE2MDY4ODYwMDR9.cR4tzLWL0hD066lHARPcPs7INnY97ZzeBGqs4JCWaHi1Y22-hFxBv5xxY0JHanydeagc8a0Z3F4ZdDqlICClrIPJB1qcMi1TUjmCiabS-brVL9LMuSwV1X_Gri1o-K5uYZL87BmLeW6K7mfRZ1XoEfweGhBgVg3hvAOiLdbzYU_zGK26GCj_oTtuMIF0aiR0MksSi5HV1vhtH-BXP_aCgi_2zSK_NKayGg-yjbGPFWFV25Aib9_mlKKygRluCvDizCWT50EV7Q1TVn11qkXNP943A0hR9ko_GQRReHLG3NQsFP9fm6PNuns2-t9bwr27Vjdlo9LCCzGkioGTMBxnIg",
    "expires_in": 0,
    "refresh_expires_in": 0,
    "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImFjY2Vzc3B1YjAifQ.eyJqdGkiOiIyNGYwOTRkOS1mZjBlLTQwNzQtODA4MC0yOTUwYjk2MjQwMjYiLCJleHAiOjAsIm5iZiI6MCwiaWF0IjoxNjA2ODg1NzI5LCJpc3MiOiJodHRwczovL2V4YW1wbGUub3JnL2F1dGgvcmVhbG1zL3N1bmJpcmQiLCJhdWQiOiJhbmRyb2lkIiwic3ViIjoiZjo1MGY5NjdkNC1iOWRiLTQ1MjgtOTUwYy1iOWYwMzMyZTYzYmE6YTFlNjRiNDEtMTZjZC00N2Y3LTk4OWQtYTYwNWU3NDBkMDQwIiwidHlwIjoiT2ZmbGluZSIsImF6cCI6ImFuZHJvaWQiLCJhdXRoX3RpbWUiOjAsInNlc3Npb25fc3RhdGUiOiIzNDNlNDBkYS0xMmE1LTRhNjctOGVmNS0zNzUzZTlmM2ZiZTMiLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsib2ZmbGluZV9hY2Nlc3MiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX19.J6DNcnUUrqyCXlBo0qtgm5csDvRTDPElZUETCBlNVFSh6SsT04frzvVRotJ2bfRFA11AqpWblyFVkopIY6hk23xzP3zxh6tw6fn6GLClvFamYIKTZi9FBMT1qhVcKtIcHDdgs69xRwZu72ip6Ks4kccOC_HTTDQ_BUpY95ZrS-P90LGb9SD4JV5XU9e7YIUPxs-bnJ-G564wRfmc7xdg8J6SZZCsD5iXyTXFT7_O3kQci9EIhwVEuS6AIOz_gWtsVW_ee1wEX8dYK2OGqXZWa00dCue6KdLshHY4vB_Gewed2V7_tAS6vAkX4vCzthC6lBKlPpzBW0KF0B-n8urfpA"
  }
}

Get a new bearer token

This API is used to obtain a bearer token

Required fields cannot be left null or empty

post

/api-manager/v1/consumer/{consumer}/credential/register

Authorizations

Path parameters

consumerstringrequired

Append any text to the request URL

Example: mobile_device

Body

requestobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://staging.open-sunbird.org/api//api-manager/v1/consumer/{consumer}/credential/register' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{"request":{"key":"text"}}'

200

400

415

500

{
  "id": "ekstep.api.am.adminutil.consumer.create",
  "ver": "1.0",
  "ts": 1606903294596,
  "params": {
    "status": "successful",
    "err": null,
    "errmsg": null,
    "msgid": "",
    "resmsgid": "0a0d4cc2-58c0-42e0-bd98-66004517cf00"
  },
  "result": {
    "key": "SunbirdUser",
    "secret": "tzppMyvMWJTA8Y5FUxoyvjCLswa47u7Pi",
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJTdW5iaXJkVXNlciIsImlhdCI6MTUxNjIzOTAyMn0.HUsyhT5jvusvN1f-Q6b9NOxAPy-HsEeC_icbpbDNjQY"
  }
}

Get a new bearer token

This API is used to obtain a bearer token

Required fields cannot be left null or empty

post

/api-manager/v2/consumer/{consumer}/credential/register

Authorizations

Path parameters

consumerstringrequired

Append any text to the request URL

Example: mobile_device

Body

requestobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://staging.open-sunbird.org/api//api-manager/v2/consumer/{consumer}/credential/register' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{"request":{"key":"text"}}'

200

400

415

500

{
  "id": "ekstep.api.am.adminutil.consumer.create",
  "ver": "1.0",
  "ts": 1606915336200,
  "params": {
    "status": "successful",
    "err": null,
    "errmsg": null,
    "msgid": "",
    "resmsgid": "3c6fdb62-1dcd-49b1-a404-bcd7e2e5a0d1"
  },
  "result": {
    "key": "SunbirdUser",
    "secret": "",
    "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Im1vYmlsZSJ9.eyJpc3MiOiJTdW5iaXJkVXNlciIsImlhdCI6MTYwNjkxNTMzNn0.FEZfy-Q-ljIxQRE-JYRu-9qlezDtgPcPGcbFU8mnWQGsHowxNGcYvKvkwVUnTE7BmpPeM4vbfv4d0cRL261daqZWj9nE4zXRglWFDn96Ll2rvi3Kb-AChKlANDhzh4MTqPigIOABX7ZPLMKlxiQx74Ezl5NYhyrbfgRK3_nt4kipyNahvhU1TIaD0DnVrnUPdosk1jtl3wP9tL7E3oKBHfN3BUiGKzYtfWcYrNtXkx5VXsn4EhIOE79GIn72cYqGIUK4cRftfntqKo4FMUk4sX-rbEOZNLQRk3WIl8XwhP3iZv2saZZSEq_EMrLW4aN0vPH9RgoL4QZqi96O7tBypg"
  }
}