Skill | Quest Protocol

Quest Protocol

Get all skills

This endpoint retrieves all the skills.

get

/skills

Query parameters

userIdstringrequired

The Id of the user performing the request.

Example: dummy-userid

entityIdstringrequired

The Id of the entity.

Example: dummy-entityid

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstring

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/skills?userId=dummy-userid&entityId=dummy-entityid' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": [
    {
      "skillId": "skill-23",
      "parentSkillId": "skill-100",
      "name": "Java",
      "description": "bunch of boilerplate"
    }
  ]
}

Successful response

Add new skill

This endpoint allows to add a new skill.

post

/skills

Query parameters

userIdstringrequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstring

The secret key for authentication

Example: test-secret

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

entityIdstringrequired

Example: entity-101

namestringrequired

Example: Java

descriptionstringrequired

Example: Java super slow

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/skills?userId=dummy-userid' \
  --header 'apikey: test' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "entityId": "entity-101",
    "name": "Java",
    "description": "Java super slow"
  }'

200

400

500

{
  "success": true,
  "skillId": "skill-101"
}

Successful response

Get skill details

This endpoint retrieves skill details.

get

/skills/{skillId}

Path parameters

skillIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstring

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/skills/{skillId}' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": {
    "skillId": "skill123",
    "parentSkillId": "parentSkill123",
    "name": "Programming",
    "description": "Description of the programming skill",
    "entityId": "entity123",
    "isEnabled": true,
    "createdAt": "2023-06-27T12:45:00Z"
  }
}

Successful response

Add multiple new skills

This endpoint allows to add multiple new skills.

post

/skills/multiple

Query parameters

userIdstringrequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstring

The secret key for authentication

Example: test-secret

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

entityIdstringrequired

Example: entity-101

skillsobject[]required

Example: [{"name":"Java","description":"Java super slow"}]

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/skills/multiple?userId=dummy-userid' \
  --header 'apikey: test' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "entityId": "entity-101",
    "skills": [
      {
        "name": "Java",
        "description": "Java super slow"
      }
    ]
  }'

200

400

500

{
  "success": true,
  "skillIds": [
    "skill-101",
    "skill-102"
  ]
}

Successful response

Make payment

This endpoint allows to make payment.

post

/payment/pay

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstring

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

idstringrequired

Example: stripe-payment-method-id

productobjectrequired

cardDataobjectrequired

infoobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/payment/pay' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "stripe-payment-method-id",
    "product": {
      "price": 100
    },
    "cardData": {
      "email": "[email protected]",
      "name": "Jon Doe",
      "country": "India",
      "zip": 12020
    },
    "info": {
      "userId": "u-1202",
      "entityId": "e-0000000000"
    }
  }'

200

400

500

{
  "success": true,
  "data": {}
}

Successful response