Quickstart

For projects listed on DePINScan.io that feature physical devices or nodes, updating the geolocation of these devices on the DePINScan world map enhances visibility and functionality. This guide walks you through using the DePINScan Location API to achieve this.

Acquiring an API key

1. Login In to depinscan.io

Navigate to https://depinscan.io and log in using one of the supported ones (Metamask, GitHub, Google).

2. Create an API Key

Within your dashboard, navigate to the "API" section and click on the "Create API key" button to generate a new API Key.

3. Locate your project UID

Your project UID is located under the "Team projects" section in the DePINScan dashboard.

4. API Testing

Utilize the official debugging tools available to test the API, which aids in quickly identifying and resolving API issues.

Access API Debug tools

API Debug tool

4. Obtain API call parameters

After testing, click the "Copy curl code" button to copy the full parameters of your call.

Example curl command:

curl -X POST "https://api.depinscan.io/api/upload-device-metrics" -H "Content-Type: application/json" -H "Authorization: mc.6c...17785ca" -d '{
  "uid": "47...5d",
  "events": [
    {
      "custom": {
        "longitude": 90.2,
        "latitude": 22
      },
      "publisher": "device-id"
    }
  ]
}'

5. Previewing your data

After uploading data, visit your project's preview page to view all uploaded data points. Note that it may take up to 2 minutes for the data to appear on the page.

Access your project's preview page

Project Prview

Please note that it takes about 2 minutes for the data to be uploaded before it can be displayed on the page