DePIN Devices

Create a new DePIN device

post

Add a new DePIN device to the system

Body
userIdstringRequired

The ID of the user who owns the device

Example: user123
networkstringRequired

The DePIN network the device belongs to

Example: helium
deviceIdentifierstringRequired

Unique identifier for the device on the network

Example: hotspot-abc123
Responses
201
DePIN device created successfully
application/json
post
POST /v1/depin-device HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "userId": "user123",
  "network": "helium",
  "deviceIdentifier": "hotspot-abc123"
}
{
  "message": "DePIN device created successfully",
  "depinDeviceId": "1",
  "userId": "user123",
  "network": "helium",
  "deviceIdentifier": "hotspot-abc123"
}

Get a specific DePIN device

get

Retrieve a DePIN device by its ID

Path parameters
deviceIdstringRequired

The ID of the DePIN device to retrieve

Example: 1
Responses
200
DePIN device retrieved successfully
application/json
get
GET /v1/depin-device/{deviceId} HTTP/1.1
Host: api.example.com
Accept: */*
{
  "depinDeviceId": "1",
  "userId": "user123",
  "network": "helium",
  "deviceIdentifier": "hotspot-abc123",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Delete a DePIN device

delete

Remove a DePIN device from the system

Path parameters
deviceIdstringRequired

The ID of the DePIN device to delete

Example: 1
Responses
200
DePIN device deleted successfully
application/json
delete
DELETE /v1/depin-device/{deviceId} HTTP/1.1
Host: api.example.com
Accept: */*
{
  "message": "DePIN device deleted successfully"
}

Get all DePIN devices for a user

get

Retrieve all DePIN devices associated with a specific user

Path parameters
userIdstringRequired

The ID of the user whose devices to retrieve

Example: user123
Responses
200
DePIN devices retrieved successfully
application/json
get
GET /v1/depin-devices/user/{userId} HTTP/1.1
Host: api.example.com
Accept: */*
[
  {
    "depinDeviceId": "1",
    "userId": "user123",
    "network": "helium",
    "deviceIdentifier": "hotspot-abc123",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
]

Get DePIN devices by network

get

Retrieve all DePIN devices from a specific network

Path parameters
networkstringRequired

The network name to filter devices by

Example: helium
Responses
200
DePIN devices retrieved successfully
application/json
get
GET /v1/depin-devices/network/{network} HTTP/1.1
Host: api.example.com
Accept: */*
[
  {
    "depinDeviceId": "1",
    "userId": "user123",
    "network": "helium",
    "deviceIdentifier": "hotspot-abc123",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
]