104 lines
2.0 KiB
Markdown
104 lines
2.0 KiB
Markdown
# Member App Channel API Examples
|
|
|
|
## Register Device Channel
|
|
|
|
### Request
|
|
|
|
```http
|
|
POST /member/channel/device/register
|
|
Authorization: Bearer <wallet-session>
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
|
|
"chain_id": 8453,
|
|
"device_id": "desktop-7f6f3a9b",
|
|
"platform": "desktop",
|
|
"app_version": "0.1.0",
|
|
"push_provider": "none"
|
|
}
|
|
```
|
|
|
|
### Response
|
|
|
|
```json
|
|
{
|
|
"channel_binding_id": "ch_01J9A4MQQ6V7H1S0A7R7ME7D4J",
|
|
"status": "active",
|
|
"poll_interval_seconds": 30,
|
|
"server_time": "2026-02-17T20:43:18Z"
|
|
}
|
|
```
|
|
|
|
## Poll Events
|
|
|
|
### Request
|
|
|
|
```http
|
|
GET /member/channel/events?wallet=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&device_id=desktop-7f6f3a9b&cursor=evt_1030&limit=25
|
|
Authorization: Bearer <wallet-session>
|
|
```
|
|
|
|
### Response
|
|
|
|
```json
|
|
{
|
|
"wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
|
|
"device_id": "desktop-7f6f3a9b",
|
|
"events": [
|
|
{
|
|
"event_id": "evt_1031",
|
|
"class": "platform_update",
|
|
"created_at": "2026-02-17T20:42:11Z",
|
|
"title": "Platform update available",
|
|
"body": "A deterministic runtime update is ready for your current platform channel.",
|
|
"dedupe_key": "platform_update:0.1.1",
|
|
"requires_ack": true,
|
|
"policy_hash": "sha256:8b903f0d3a...",
|
|
"payload": {
|
|
"version": "0.1.1",
|
|
"channel": "stable"
|
|
}
|
|
}
|
|
],
|
|
"next_cursor": "evt_1031",
|
|
"server_time": "2026-02-17T20:43:20Z"
|
|
}
|
|
```
|
|
|
|
## Acknowledge Event
|
|
|
|
### Request
|
|
|
|
```http
|
|
POST /member/channel/events/evt_1031/ack
|
|
Authorization: Bearer <wallet-session>
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
|
|
"device_id": "desktop-7f6f3a9b",
|
|
"acknowledged_at": "2026-02-17T20:43:25Z"
|
|
}
|
|
```
|
|
|
|
### Response
|
|
|
|
```json
|
|
{
|
|
"status": "acknowledged",
|
|
"event_id": "evt_1031",
|
|
"acknowledged_at": "2026-02-17T20:43:25Z"
|
|
}
|
|
```
|
|
|
|
## Membership Inactive Error
|
|
|
|
```json
|
|
{
|
|
"error": "membership_inactive",
|
|
"code": "membership_inactive",
|
|
"correlation_id": "req_01J9A4Q9GPDXDNZEWJ2FJS6F5R"
|
|
}
|
|
```
|