How to get list of skills present in an ALM account using API

May 26, 2024

Anupam Gogoi Follow

(1)

Comments

(0)

May 26, 2024

How to get list of skills present in an ALM account using API

Anupam Gogoi Follow

(1)

(0)

Summary

The ALM API provides an endpoint to access all skills within an Adobe Learning Manager account. The retrieved data includes the skill ID, skill levels, name, description, and state.

GET /skills

Retrieves a list of all skills for an ALM account

Implementation Notes

Get a list of all the skills for an account, It includes the skill name and description of each skill

Response Class (Status 200)

Operation successful

Example Value

{
  "data": [
    {
      "id": "string",
      "type": "string",
      "attributes": {
        "description": "string",
        "name": "string",
        "state": "string"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "type": "string",
              "id": "string"
            }
          ]
        }
      }
    }
  ]
}

Response Content-Type application/vnd.api+json;charset=UTF-8

Parameters

Parameter	Value	Description	Parameter Type	Data Type
include	refer – https://elearning.adobe.com/?p=171607	Mention any additional model to be tagged along with this model	query	string
page[offset]	0	Mention the starting range value of the records to be displayed in page	query	integer
page[limit]	5	Mention the maximum number of records to be displayed per page. Max allowed is 10	query	integer
sort	name (default) -name	Choose the type of sorting to be applied to the results. Sorting based on recommendation score will only be applicable for PRL enabled LOs	query	string
ids		Mention Skill Ids for which data is being requested. page[offset] & page[limit] are not honored if this field is mentioned.Max allowed number of ids that can be included is 10	query	Array[]
filter.excludeSkillInterest		TBD	query	string

Response Messages

HTTP Status Code	Reason	Response Model	Headers
400	A generic http bad request error	`{ "meta": { "error": "string", "detail": "string" } }`
401	A generic http unauthorized access error. Access is denied due to invalid credentials	`{ "meta": { "error": "string", "detail": "string" } }`

Curl

curl -X GET --header 'Accept: application/vnd.api+json' --header 'Authorization: oauth 2fr56e3h7d8739caecd258732b601ad4fe8e203' 'https://learningmanager.adobe.com/primeapi/v2/skills?page[offset]=0&page[limit]=5&sort=name'

Request URL

https://learningmanager.adobe.com/primeapi/v2/skills?page[offset]=0&page[limit]=5&sort=name

Response Body

{
  "links": {
    "self": "https://learningmanager.adobe.com/primeapi/v2/skills?page[offset]=0&page[limit]=5&sort=name",
    "next": "https://learningmanager.adobe.com/primeapi/v2/skills?page[offset]=5&page[limit]=5&sort=name"
  },
  "data": [
    {
      "id": "278737",
      "type": "skill",
      "attributes": {
        "description": "After Effects",
        "name": "After Effects",
        "state": "Retired"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "id": "278737_1",
              "type": "skillLevel"
            }
          ]
        }
      }
    },
    {
      "id": "414812",
      "type": "skill",
      "attributes": {
        "description": "After Effects",
        "name": "After Effects*",
        "state": "Retired"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "id": "414812_1",
              "type": "skillLevel"
            }
          ]
        }
      }
    },
    {
      "id": "279445",
      "type": "skill",
      "attributes": {
        "description": "This is a test account. Do not use.",
        "name": "Anupam's admin trial",
        "state": "Retired"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "id": "279445_1",
              "type": "skillLevel"
            },
            {
              "id": "279445_2",
              "type": "skillLevel"
            }
          ]
        }
      }
    },
    {
      "id": "414663",
      "type": "skill",
      "attributes": {
        "name": "Art",
        "state": "Active"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "id": "414663_1",
              "type": "skillLevel"
            }
          ]
        }
      }
    },
    {
      "id": "408925",
      "type": "skill",
      "attributes": {
        "name": "C.skill",
        "state": "Active"
      },
      "relationships": {
        "levels": {
          "data": [
            {
              "id": "408925_1",
              "type": "skillLevel"
            }
          ]
        }
      }
    }
  ]
}

Response Code

Response Headers

{
  "access-control-allow-credentials": "true",
  "access-control-allow-headers": "X-acap-all-roles, X-acap-account,X-acap-user,X-acap-caller-role,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type, x-experience-api-version, Authorization, X-CSRF-TOKEN, X-HTTP-Method-Override, X-acap-ug-manager-scope, X-acap-extension-token",
  "access-control-allow-methods": "GET, POST, OPTIONS, PUT, HEAD, DELETE, PATCH",
  "access-control-expose-headers": "Requested-Accept-Language, x-rate-limit, x-burst, x-excess-requests-per-second, Retry-After",
  "age": "-1",
  "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
  "content-encoding": "gzip",
  "content-type": "application/vnd.api+json;charset=UTF-8",
  "date": "Sun, 26 May 2024 17:13:17 GMT",
  "expires": "-1",
  "pragma": "no-cache",
  "requested-accept-language": "en-US,en;q=0.9",
  "server": "openresty",
  "server-timing": "server_resp;dur=16",
  "strict-transport-security": "max-age=31536000; includeSubDomains",
  "x-content-type-options": "nosniff",
  "x-frame-options": "SAMEORIGIN",
  "x-request-id": "gwea79d1a9ce3cdd0bb310bf4596a1f2c399449",
  "x-xss-protection": "1"
}

—————————————————————————————–

-Tags-

#How to extract skills from ALM using API #How to extract skill levels #All skills #All skill levels #json #API call

Adobe Learning Manager

Adobe LMS

blog

integrations

(1)

Comments

(0)