swag-questionary/spec/swagger.yaml
2020-01-24 19:48:19 +03:00

68 lines
1.8 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

swagger: '2.0'
info:
version: '0.0.1'
title: RBKmoney Questionary Resource API
description: >
RBKmoney Questionary Resource API для работы с анкетами.
termsOfService: http://rbk.money/
contact:
name: RBKmoney support team
email: support@rbk.money
url: https://rbk.money
host: api.rbk.money
basePath: /questionary/v0
schemes:
- https
consumes:
- application/json; charset=utf-8
produces:
- application/json; charset=utf-8
securityDefinitions:
bearer:
type: apiKey
name: Authorization
in: header
description: >
Для аутентификации вызовов мы используем [JWT](https://jwt.io).
Cоответствующий ключ передается в заголовке.
```shell
Authorization: Bearer {TOKENIZATION|PRIVATE_JWT}
```
security:
- bearer: []
responses:
QuestionaryNotFound:
description: Заданный ресурс не найден
schema:
$ref: '#/definitions/GeneralError'
Unauthorized:
description: Ошибка авторизации
ExternalIDConflict:
description: Переданное значение `externalID` уже использовалось вами ранее с другими параметрами запроса
schema:
$ref: '#/definitions/ExternalIDConflictError'
GeneralError:
description: Неверные данные
schema:
$ref: '#/definitions/GeneralError'
parameters:
requestID:
name: X-Request-ID
in: header
description: Уникальный идентификатор запроса к системе
required: true
type: string
maxLength: 32
minLength: 1
tags:
- name: Questionary
x-displayName: Управление анкетами
description: ""