管理标签
Add or remove label from chat/message
OpenAPI
/api-reference/openapi/WTO-WA-API/label.yaml post /label/handleLabel/{instanceName}
openapi: 3.0.4
info:
title: WTO - WTO WA API - Label
description: Main WTO WA API for WhatsApp
version: 2.3.7
servers:
- url: http://localhost:8080
description: Local development server
- url: https://api.wtocrm.com
description: Production server
- url: '{customUrl}'
description: Custom server
variables:
customUrl:
default: https://your-instance.com
description: Enter your server URL
security:
- ApiKeyAuth: []
paths:
/label/handleLabel/{instanceName}:
post:
summary: Handle Label
description: Add or remove label from chat/message
parameters:
- $ref: '#/components/parameters/InstanceName'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- type
- id
properties:
name:
type: string
type:
type: string
enum:
- chat
- message
id:
type: string
action:
type: string
enum:
- add
- remove
responses:
'200':
description: Label handled successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
message:
type: string
example:
success: true
message: Label handled successfully
'400':
description: Bad Request - Invalid input data
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: BAD_REQUEST
message: Invalid request data. Name, type, and id are required.
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /label/handleLabel/{instanceName}
method: POST
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: UNAUTHORIZED
message: Invalid or missing API key
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /label/handleLabel/{instanceName}
method: POST
'403':
description: Forbidden - Insufficient permissions
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: FORBIDDEN
message: Insufficient permissions to handle label
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /label/handleLabel/{instanceName}
method: POST
'404':
description: Not Found - Instance, chat, message, or label not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: NOT_FOUND
message: Instance, chat, message, or label not found
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /label/handleLabel/{instanceName}
method: POST
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: INTERNAL_SERVER_ERROR
message: An unexpected error occurred
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /label/handleLabel/{instanceName}
method: POST
components:
parameters:
InstanceName:
name: instanceName
in: path
required: true
description: WhatsApp instance name
schema:
type: string
example: my-instance
schemas:
ErrorResponse:
type: object
required:
- success
- error
properties:
success:
type: boolean
example: false
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
meta:
type: object
properties:
timestamp:
type: string
format: date-time
path:
type: string
method:
type: string
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: apikey
description: API Key for authentication (global or instance-specific)