Skills

Fetch All Skills

Endpoint: /api/skill/

List all skills in Skillhive.

Method	Action	Parameters
GET	Get all skills	offset: int fetch skills from (optional, default: 0) limit: int how many skills to get (optional, default: 20, limit 0-50)

An example of a return response:

{
  "limit":20,
  "offset":0,
  "total_count":214,
  "previous":null,
  "next":"/api/skill/?offset=20&limit=20",
  "collection": [
    {
      "id":67521,
      "uri":"/api/skill/?skill=Scrum",
      "name":"Scrum",
      "description":"Scrum is an agile method.",
      "competence_avg": 65,
      "interest_avg": 78,
      "expert_count": 250,
      "resources":{
        "users":"/api/user/?skill[]=Scrum",
        "swarms":"/api/swarm/?skill[]=Scrum"
      }
    },
    {
      "id":67521,
      "uri":"/api/skill/?skill=PHP",
      "name":"PHP",
      "description":"PHP is a programming language...",
      "competence_avg": 89,
      "interest_avg": 65,
      "expert_count": 120,
      "resources":{
        "users":"/api/user/?skill[]=PHP",
        "swarms":"/api/swarm/?skill[]=PHP"
      }
    },
    ...
  ]
}

Fetch Skill Details

Endpoint: /api/skill/?skill=:skillname

This is the "skill page" which shows a summary of experts and swarms who have this skills.

Method	Action	Parameters
GET	Get skill details	N/A

An example of a return response:

{
  "id":67521,
  "uri":"/api/skill/?skill=Scrum",
  "name":"Scrum",
  "description":"Scrum is an agile method.",
  "competence_avg": 89,
  "interest_avg": 65,
  "expert_count": 120,
  "resources":{
    "users":"/api/user/?skill[]=Scrum",
    "swarms":"/api/swarm/?skill[]=Scrum"
  }
}    

Fetching User Skills

Endpoint: /api/user/:user_id/skill/

Fetch a user's personal skills and competences. The skills are ordered by highlight, competence and interest.

Method	Action	Parameters
GET	List a user's skills	Offset: int fetch skills starting from (optional, default: 0) Limit: int how many skills to get (optional, default: 20, limit 0-200)

An example of a return response:

{
  "limit":20,
  "offset":0,
  "previous":null,
  "total_count": 92
  "next":"/api/user/123456/skill/?offset=20&limit=20",
  "collection": [
    {
      "id":67521,
      "uri":"/api/user/123456/skill/67521/",
      "name":"Scrum",
      "is_highlight":false,
      "competence":72,
      "interest":65,
      "recommendations":3
      "created_at":
      "updated_at":
    },
    {
      "id":67523,
      "uri":"/api/user/123456/skill/67523/",
      "name":"PHP",
      "is_highlight":true,
      "competence":91,
      "interest":89,
      "recommendations":4
      "created_at":
      "updated_at":
    }
    ...
  ]
}

Endpoint: /api/user/:user_id/skill/:skill_id

Fetch a single user skill.

Method	Action	Parameters
GET	Get a single skill by user.	N/A

An example of a return response:

{
  "id":67521,
  "uri":"/api/user/123456/skill/67521/",
  "name":"Scrum",
  "is_highlight":false,
  "competence":72,
  "interest":65,
  "recommendations":3
  "created_at":
  "updated_at":
}