/*
  Сервис реализует функционал взаимодействия с внешними партнёрами IoT
*/
syntax = "proto3";

import "google/protobuf/timestamp.proto";
import "google/api/annotations.proto";
import "google/api/field_behavior.proto";
import "keyapis/iot_connect/v1/keyapis_iot_connect_callback_v1.proto";
import "google/protobuf/wrappers.proto";

package keyapis.iot_connect.v1;

option java_package = "ru.keyapis.iot_connect.v1";
option java_outer_classname = "KeyapisIotConnectV1Proto";
option java_multiple_files = false;
option java_string_check_utf8 = true;
option go_package = "/keyapis_iot_connect_v1";
option cc_enable_arenas = true;
option csharp_namespace = "Keyapis.IotConnect.V1";
option objc_class_prefix = "KEYAPISIOTCONNECTV1";
option php_namespace = "Keyapis\\IotConnect\\V1";
option ruby_package = "Keyapis::IotConnect::V1";
option optimize_for = LITE_RUNTIME;

// Сервис для отправки команд и сообщений внешним партнёрам IoT
service IotConnectManageService{

  // Ключ отправляет внешнему партнёру факт изменения состояния устройства.
  // В данном случае имеется в виду переход состояния домофона из состояния "нет вызова в квартиру" -> "есть вызов в квартиру".
  // Метод доступен для: admin
  rpc PostManageState(PostManageStateRequest) returns (PostManageStateResponse)
  {
    option (google.api.http) = {
      post: "/iot_connect/api/v1/manage/state"
    };
  }

  // Внешний партнёр IoT отправляет в Ключ сообщение, что пользователь разъединил свой ID и аккаунт Ключа. Аккаунты на стороне партнёра разъединяются независимо от ответа вендора.
  // Ссылка на раздел документации: https://developers.sber.ru/docs/ru/smarthome/c2c/webhook-post-unlink.
  // Метод доступен для: admin
  rpc PostManageUnlinkUser(PostManageUnlinkUserRequest) returns (PostManageUnlinkUserResponse)
  {
    option (google.api.http) = {
      post: "/iot_connect/api/v1/manage/unlink_user"
    };
  }

}

//Сообщение об изменении состояния устройства (домофона)
message PostManageStateRequest {
  string key = 1;                 // Ключ состояния
//  TypedValue value = 2;           // Значение с указанием типа
}

// Ответ
message PostManageStateResponse {
}

// Запрос-информирование о разъединении аккаунтов
message PostManageUnlinkUserRequest {
}

// Ответ на запрос-информирование о разъединении аккаунтов
message PostManageUnlinkUserResponse {
}