shutterstock/openapi.yaml

87 lines
2.2 KiB
YAML
Raw Normal View History

2024-10-13 18:31:38 +00:00
openapi: 3.0.0
info:
title: ShutterStock Service API
version: 1.0.0
description: API для общения с ShutterStock.
paths:
/:
get:
summary: Поиск изображений на Shutterstock
description: Выполняет поиск изображений на Shutterstock по заданным параметрам
tags:
- Shutterstock
requestBody:
description: Параметры поиска изображений
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImgSearchReq'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ImgSearchResp'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ImgSearchReq:
type: object
properties:
query:
type: string
aspect_ratio:
type: number
format: float
aspect_ratio_max:
type: number
format: float
aspect_ratio_min:
type: number
format: float
width_from:
type: integer
width_to:
type: integer
height_from:
type: integer
height_to:
type: integer
ImgSearchResp:
type: object
properties:
data:
type: array
description: Массив с результатами
items:
$ref: '#/components/schemas/ImgSearchData'
ImgSearchData:
type: object
properties:
id:
type: string
description: Идентификатор изображения
ErrorResponse:
type: object
properties:
error:
type: string
description: Error