🙇Authentication

User signature is required to fetch data

Arrange Data

First, you need to arrange data which will be used to generate message

{
    "owner": "string" // can be address or DID
}

Generate a message

Generate Message to read data

POSThttps://sandbox-api.fetcch.xyz/v1/authentication/generate-message

Body

application/json

ownerstring

Response

200400401

Headers

Body

application/json

statusstring

dataobject

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/authentication/generate-message', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401

{
  "status": "text",
  "data": {
    "message": "text",
    "timestamp": 0
  },
  "timestamp": "2024-12-21T14:57:06.709Z"
}

Generate Access Tokens

Sign the above message using the appropriate address and arrange data in below format

{
    "owner": "string",
    "signature": "string",
    "timestamp": "number"
}

signature is the obtained by signing the above generated message and timestamp is also given in the response of this

timestamp can't be older than 5 minutes

Authenticate the signature

POSThttps://sandbox-api.fetcch.xyz/v1/authentication

Body

application/json

ownerstring

signaturestring

timestampinteger

Response

200400401

Headers

Body

application/json

statusstring

dataobject

timestampstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://sandbox-api.fetcch.xyz/v1/authentication', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401

{
  "status": "text",
  "data": {
    "accessToken": "text",
    "expiry": "2024-12-21T14:57:06.709Z"
  },
  "timestamp": "2024-12-21T14:57:06.709Z"
}

Authenticate

To authenticate, just include the received accessToken in headers as authorization in format bearer ${accessToken}