LeadMagnet/leadchat
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

Fix: Make swagger doc compliant to OpenAPI (#3394)

Browse Source 
This fixes issues in the swagger.json file. The motivation to do so is to be able to generate API clients using https://openapi-generator.tech Doing so will require further changes to the api spec, but this seems like a good first step since it is now "valid" according to editor.swagger.io and openapi-generator validate.

Fixes #2806
This commit is contained in:
Jan-David
2021-11-17 14:25:15 +01:00
committed by GitHub
parent d227a56747
commit e500d1216b
55 changed files with 527 additions and 695 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
swagger/paths/application/conversation/create.yml
View File

@@ -1,41 +0,0 @@
get:
tags:
- Conversation
operationId: conversationList
description: List all the conversations with pagination
summary: Conversations List
parameters:
- $ref: '#/parameters/account_id'
- name: assignee_type
in: query
type: string
enum: ['me', 'unassigned', 'all', 'assigned']
required: true
- name: status
in: query
type: string
enum: ['open', 'resolved', 'pending']
required: true
- name: page
in: query
type: integer
required: true
- name: inbox_id
in: query
type: integer
- name: labels
in: query
type: array
items:
type: string
responses:
200:
description: Success
schema:
$ref: '#/definitions/conversation_list'
400:
description: Bad Request Error
schema:
$ref: '#/definitions/bad_request_error'
description: Access denied

85
swagger/paths/application/conversation/filter.yml
View File

@@ -1,44 +1,43 @@
post:
tags:
- Conversation
operationId: conversationFilter
description: Filter conversations with custom filter options and pagination
summary: Conversations Filter
security:
- userApiKey: []
- agentBotApiKey: []
parameters:
- name: page
in: query
type: integer
- name: payload
in: body
required: true
schema:
type: array
items:
type: object
properties:
attribute_key:
tags:
- Conversation
operationId: conversationFilter
description: Filter conversations with custom filter options and pagination
summary: Conversations Filter
security:
- userApiKey: []
- agentBotApiKey: []
parameters:
- name: page
in: query
type: integer
- name: payload
in: body
required: true
schema:
type: array
items:
type: object
properties:
attribute_key:
type: string
description: filter attribute name
filter_operator:
type: string
description: filter operator name
values:
type: array
items:
type: string
description: filter attribute name
filter_operator:
type: string
description: filter operator name
values:
type: array
description: array of the attribute values to filter
query_operator:
type: string
description: query operator name
- $ref: '#/parameters/account_id'
responses:
200:
description: Success
schema:
$ref: '#/definitions/conversation_list'
400:
description: Bad Request Error
schema:
$ref: '#/definitions/bad_request_error'
description: Access denied
description: array of the attribute values to filter
query_operator:
type: string
description: query operator name
responses:
200:
description: Success
schema:
$ref: '#/definitions/conversation_list'
400:
description: Bad Request Error
schema:
$ref: '#/definitions/bad_request_error'

24
swagger/paths/application/conversation/index.yml
View File

@@ -1,24 +1,27 @@
parameters:
- $ref: '#/parameters/account_id'
get:
tags:
- Conversation
operationId: conversationSearch
description: Search for conversations containing a messages with the query string
summary: Conversations Search
operationId: conversationList
description: List all the conversations with pagination
summary: Conversations List
parameters:
- name: q
in: query
type: string
- name: assignee_type
in: query
type: string
enum: ['me', 'unassigned', 'all', 'assigned']
required: true
- name: status
in: query
type: string
enum: ['open', 'resolved', 'pending', 'all']
enum: ['open', 'resolved', 'pending']
required: true
- name: page
in: query
type: integer
required: true
- name: inbox_id
in: query
type: integer
@@ -27,7 +30,6 @@ get:
type: array
items:
type: string
- $ref: '#/parameters/account_id'
responses:
200:
@@ -38,8 +40,6 @@ get:
description: Bad Request Error
schema:
$ref: '#/definitions/bad_request_error'
description: Access denied
post:
tags:
@@ -51,7 +51,6 @@ post:
- userApiKey: []
- agentBotApiKey: []
parameters:
- $ref: '#/parameters/account_id'
- name: data
in: body
required: true
@@ -59,7 +58,8 @@ post:
type: object
properties:
source_id:
$ref: '#/parameters/source_id'
type: string
description: Conversation source id
inbox_id:
type: string
description: "Id of inbox in which the conversation is created <br/> Allowed Inbox Types: Website, Phone, Api, Email "

2
swagger/paths/application/conversation/labels/create.yml
View File

@@ -13,7 +13,7 @@ parameters:
labels:
type: array
description: Array of labels (comma-separated strings)
properties:
items:
type: string
responses:
200:

3
swagger/paths/application/conversation/messages/create_attachment.yml
View File

@@ -31,7 +31,8 @@ post:
type: array
description: The files to be uploaded.
items:
type: file
type: string
format: binary
responses:

11
swagger/paths/application/conversation/messages/index.yml
View File

@@ -6,12 +6,13 @@ description: List all messages of a conversation
responses:
200:
description: Success
type: array
description: Array of messages
schema:
allOf:
- $ref: '#/definitions/generic_id'
- $ref: '#/definitions/message'
type: array
description: Array of messages
items:
allOf:
- $ref: '#/definitions/generic_id'
- $ref: '#/definitions/message'
404:
description: Conversation not found
401:

3
swagger/paths/application/conversation/toggle_status.yml
View File

@@ -12,11 +12,12 @@ parameters:
required: true
schema:
type: object
required:
- status
properties:
status:
type: string
enum: ["open", "resolved", "pending"]
required: true
description: The status of the conversation
responses:
200: