The following macros are not currently supported in the header:
  • style

List Skills

Owned by Kurt Wagner (Unlicensed)
Feb 29, 2016

Resource URL

Returns an array of skills.

GET /skills

Parameters

Table of allowed parameters.

_pageunsigned intThe page of the list to display. For example, 5 will display the fifth page. Each page contains 10 resources.
_limitunsigned intThe maximum number of resources to return. Default is 10 and maximum is 50.
_offsetunsigned intThe position in the list of resources to return from. For example, if you had 20 resources and requested an offset of 10. Resources 10 to 19 would be returned. Offset cannot be used in conjunction with _page.
_searchstringSearch for skills using a query string.
_filterspartial stringFilter skills

Filtering expense

You can filter the returned list using the _filters parameter. You can stack filters. For example,_filters=id(21,3),title(javascript)

 

Name
Example
Description
id(...) or id_not(...)_filters=id(12,3)Only return skills with or without given id(s).
title(...) or title_not(...)_filters=title(javascript)Only return skills with or without given title(s).
against(type1(...),typeN(...))_filters=against(job(1,4), issue(2,4))Only return skills with the matching against values. The example will only return skills against job 1 and 4 or skills against issue 1 and 4.

Handling the response

The skill response will always return the skill id and title.

Sample
{
  "response": {
    "skills": [
      {
        "id": "20",
        "title": "Perl"
      },
      {
        "title": "Javscript",
        "id": "18"
      },
      {
        "title": "C++",
        "id": "9"
      },
      {
        "title": "Android",
        "id": "7"
      }
    ]
  },
  "meta": {
    "status": "ok",
    "message": "Everything executed as expected.",
    "more_info": "https://affinitylive.jira.com/wiki/display/APIS/Status+Codes#ok"
  }
}