chirpstack_api 4.17.0

ChirpStack Protobuf / gRPC API definitions.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

syntax = "proto3";

package api;

option go_package = "github.com/chirpstack/chirpstack/api/go/v4/api";
option java_package = "io.chirpstack.api";
option java_multiple_files = true;
option java_outer_classname = "RelayProto";
option csharp_namespace = "Chirpstack.Api";
option php_namespace = "Chirpstack\\Api";
option php_metadata_namespace = "GPBMetadata\\Chirpstack\\Api";

import "google/api/annotations.proto";
import "google/protobuf/timestamp.proto";
import "google/protobuf/empty.proto";

// RelayService is the service providing API methos for managing relays.
service RelayService {
    // List lists the relays for the given application id.
    rpc List(ListRelaysRequest) returns (ListRelaysResponse) {
        option(google.api.http) = {
            get: "/api/relays"
        };
    }

    // AddDevice adds the given device to the relay.
    rpc AddDevice(AddRelayDeviceRequest) returns (google.protobuf.Empty) {
        option(google.api.http) = {
            post: "/api/relays/{relay_dev_eui}/devices"
            body: "*"
        };
    }

    // RemoveDevice removes the given device from the relay.
    rpc RemoveDevice(RemoveRelayDeviceRequest) returns (google.protobuf.Empty) {
        option(google.api.http) = {
            delete: "/api/relays/{relay_dev_eui}/devices/{dev_eui}"
        };
    };

    // ListDevices lists the devices for the given relay.
    rpc ListDevices(ListRelayDevicesRequest) returns (ListRelayDevicesResponse) {
        option(google.api.http) = {
            get: "/api/relays/{relay_dev_eui}/devices"
        };
    };
}

message RelayListItem {
    // DevEUI (EUI64).
    string dev_eui = 1;

    // Name.
    string name = 2;
}

message ListRelaysRequest {
    // Max number of devices to return in the result-set.
    // If not set, it will be treated as 0, and the response will only return the total_count.
    uint32 limit = 1;

    // Offset in the result-set (for pagination).
    uint32 offset = 2;

    // Application ID (UUID).
    string application_id = 3;
}

message ListRelaysResponse {
    // Total number of relays.
    uint32 total_count = 1;

    // Result-set.
    repeated RelayListItem result = 2;
}

message AddRelayDeviceRequest {
    // Relay DevEUI (EUI64).
    string relay_dev_eui = 1;

    // Device DevEUI (EUI64).
    string device_dev_eui = 2;

}

message RemoveRelayDeviceRequest {
    // Relay DevEUI (EUI64).
    string relay_dev_eui = 1;

    // Device DevEUI (EUI64).
    string device_dev_eui = 2;
}

message ListRelayDevicesRequest {
    // Max number of multicast groups to return in the result-set.
    // If not set, it will be treated as 0, and the response will only return the total_count.
    uint32 limit = 1;

    // Offset in the result-set (for pagination).
    uint32 offset = 2;

    // Relay DevEUI (EUI64).
    string relay_dev_eui = 3;
}

message RelayDeviceListItem {
    // DevEUI (EUI64).
    string dev_eui = 1;

    // Created at timestamp.
    google.protobuf.Timestamp created_at = 2;

    // Device name.
    string name = 3;
}

message ListRelayDevicesResponse {
    // Total number of devices.
    uint32 total_count = 1;

    // Result-set.
    repeated RelayDeviceListItem result = 2;
}