App Metric

Get all app metrics

This endpoint retrieves all the app metrics.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/metrics

Path parameters

entityId*string

Query parameters

Header parameters

Response

200400500

Successful response

Body

application/json

successboolean

Example: true

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/metrics?userId=dummy-userid', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200400500

{
  "success": true,
  "data": {
    "id": "id-1",
    "name": "app-metric-name"
  }
}

Create a new app metric

This endpoint allows creating a new app metric.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/metrics

Path parameters

entityId*string

Query parameters

Header parameters

Body

application/json

metric*string

Example: "metric-1"

namestring

Example: "Metric Name"

descriptionstring

Example: "Metric description"

typestring

Example: "metric_type"

thresholdTimenumber

Example: 10

platformstring

Example: "segment"

eventNamestring

Example: "metric_event"

Response

200400500

Successful response

Body

application/json

successboolean

Example: true

dataDappMetric (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/metrics?userId=dummy-userid', {
    method: 'POST',
    headers: {
      "apikey": "test",
      "token": "dummy-token",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "metric": "metric-1"
    }),
});
const data = await response.json();

Response

200400500

{
  "success": true,
  "data": {
    "metric": "metric-1",
    "entityId": "entityId-1",
    "type": "metric_type",
    "name": "Metric Name",
    "description": "Metric description",
    "thresholdTime": 10,
    "isEnabled": true,
    "createdAt": "2023-01-01T00:00:00Z",
    "platform": "segment",
    "eventName": "metric_event"
  }
}

Get app metrics info of a user

This endpoint retrieves the app metrics info for a user.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics/{metric}

Path parameters

entityId*string

userId*string

metric*string

Header parameters

Response

200400401500

Successful response

Body

application/json

successboolean

Example: true

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics/{metric}', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "userid": "dummy-userid",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200400401500

{
  "success": true,
  "data": {
    "metric": "metric-1",
    "counter": 10
  }
}

Increment app metrics for a user

This endpoint allows to increment app metrics of a user.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics/{metric}

Path parameters

entityId*string

userId*string

metric*string

Query parameters

Header parameters

Body

application/json

countnumber

Example: 10

Response

200400401500

Successful response

Body

application/json

successboolean

Example: true

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics/{metric}?userId=dummy-userid', {
    method: 'POST',
    headers: {
      "apikey": "test",
      "userid": "dummy-userid",
      "token": "dummy-token",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401500

{
  "success": true
}

Get all app metrics of a user

This endpoint retrieves all the app metrics for a user.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics

Path parameters

entityId*string

userId*string

Query parameters

Header parameters

Response

200400401500

Successful response

Body

application/json

successboolean

Example: true

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics?userId=dummy-userid', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200400401500

{
  "success": true,
  "data": {
    "id": "id-1",
    "name": "app-metric-name"
  }
}

Increment multiple app metrics for a user

This endpoint allows to increment multiple app metrics of a user.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics

Path parameters

entityId*string

userId*string

Query parameters

Header parameters

Body

application/json

metricsarray of object

Response

200400401500

Successful response

Body

application/json

successboolean

Example: true

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/metrics?userId=dummy-userid', {
    method: 'POST',
    headers: {
      "apikey": "test",
      "token": "dummy-token",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401500

{
  "success": true
}

Delete an app metric

This endpoint allows deleting an app metric.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/metrics/{metric}/delete

Path parameters

entityId*string

metric*string

Query parameters

Header parameters

Response

200500

Successful response

Body

application/json

successboolean

Example: true

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/metrics/{metric}/delete?userId=dummy-userid', {
    method: 'POST',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200500

{
  "success": true
}

Update an app metric

This endpoint allows updating an app metric.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/metrics/{metric}/update

Path parameters

entityId*string

metric*string

Query parameters

Header parameters

Body

application/json

namestring

descriptionstring

typestring

thresholdTimenumber

platformstring

eventNamestring

Response

200500

Successful response

Body

application/json

successboolean

Example: true

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/metrics/{metric}/update?userId=dummy-userid', {
    method: 'POST',
    headers: {
      "apikey": "test",
      "token": "dummy-token",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "Updated Metric Name",
      "description": "<p>Updated metric description.</p>",
      "type": "counter",
      "thresholdTime": 3600,
      "platform": "segment",
      "eventName": "updated_event",
      "__$markdownParsed": true
    }),
});
const data = await response.json();

Response

200500

{
  "success": true
}

Get metric claim summary

This endpoint retrieves a summary of metric claims for an entity.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/metrics/claims

Path parameters

entityId*string

Query parameters

Header parameters

Response

200500

Successful response

Body

application/json

successboolean

Example: true

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/metrics/claims?userId=dummy-userid', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200500

{
  "success": true,
  "data": [
    {
      "metric": "metric-1",
      "count": 10
    }
  ]
}

Get Dapp metric value for entity

This endpoint retrieves the value of a Dapp metric for an entity.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/getmetrics/{metric}

Path parameters

entityId*string

userId*string

metric*string

Query parameters

Header parameters

Response

200500

Successful response

Body

application/json

successboolean

Example: true

datanumber

Example: 10

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/getmetrics/{metric}?userId=dummy-userid', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200500

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

Get metric summary for a quest

This endpoint retrieves the metric summary for a quest in a specified entity.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/quests/{questId}/metric-summary

Path parameters

entityId*string

questId*string

Query parameters

Header parameters

Response

200401500

Successful response

Body

application/json

successboolean

Example: true

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/quests/{questId}/metric-summary?userId=dummy-userid', {
    method: 'GET',
    headers: {
      "apikey": "test",
      "token": "dummy-token"
    },
});
const data = await response.json();

Response

200401500

{
  "success": true,
  "data": [
    {
      "metric": "quest-metric-1",
      "date": "2023-12-31",
      "count": 10,
      "metricDetails": {
        "metric": "quest-metric-1",
        "entityId": "entity-id-1",
        "type": "metric-type",
        "name": "metric-name",
        "description": "metric-description",
        "thresholdTime": 60000,
        "isEnabled": true,
        "createdAt": "2023-01-01T00:00:00Z",
        "platform": "segment",
        "eventName": "metric-event"
      }
    }
  ]
}