/*
  Сервис управления компаниями
*/
syntax = "proto3";

import "google/api/annotations.proto";
import "google/api/field_behavior.proto";
import "google/protobuf/timestamp.proto";
import "keyapis/vc/v1/keyapis_vc_camera_v1.proto";

package keyapis.vc.v1;

option java_package = "ru.keyapis.vc.v1";
option java_outer_classname = "KeyapisVcV1Proto";
option java_multiple_files = false;
option java_string_check_utf8 = true;
option go_package = "/keyapis_vc_v1";
option cc_enable_arenas = true;
option csharp_namespace = "Keyapis.Vc.V1";
option objc_class_prefix = "KEYAPISVCV1";
option php_namespace = "Keyapis\\Vc\\V1";
option ruby_package = "Keyapis::Vc::V1";
option optimize_for = LITE_RUNTIME;

// Сервис управления компаниями
service CompanyService {
  // Метод генерации имперсонационной ссылки для владельца компании.
  // Возвращает одноразовую ссылку для имперсонации в сервисе inkey-front.
  // Сценарий работы метода: https://confluence.rt.ru/pages/viewpage.action?pageId=1013775798.
  // Метод доступен для: service, bti, admin
  rpc PostCompanyImpersonation(PostCompanyImpersonationRequest) returns (PostCompanyImpersonationResponse) {
    option (google.api.http) = {
      post: "/vc/api/v1/company/{company_id}/impersonation"
      body: "*"
    };
  }
}

// Запрос генерации имперсонационной ссылки для компании
message PostCompanyImpersonationRequest {
  // Идентификатор компании.
  // # Диапазон: 1..2147483647
  int32 company_id = 1 [(google.api.field_behavior) = REQUIRED];
}

// Ответ на запрос генерации имперсонационной ссылки для компании
message PostCompanyImpersonationResponse {
  // Ошибка генерации имперсонационной ссылки для компании
  message Error {
    // Владелец компании не найден
    message OwnerNotFound {}
    // Ошибка взаимодействия с сервисом User
    message UserServiceError {}
    // Ошибка взаимодействия с сервисом vcfront
    message VcfrontServiceError {}

    // Причина ошибки
    oneof reason {
      // Ошибка валидации
      ValidationError validation = 1;
      // Владелец компании не найден
      OwnerNotFound owner_not_found = 2;
      // Ошибка взаимодействия с сервисом User
      UserServiceError user_service_error = 3;
      // Ошибка взаимодействия с сервисом vcfront
      VcfrontServiceError vcfront_service_error = 4;
    }
  }

  // Имперсонационная ссылка
  message CompanyImpersonation {
    // Одноразовая ссылка для имперсонации
    string url = 1 [(google.api.field_behavior) = REQUIRED];
  }

  // Тип результата
  oneof type {
    // Имперсонационная ссылка
    CompanyImpersonation data = 1;
    // Ошибка
    Error error = 2;
  }
}