Operações básicas para manipulação dos dados das filas.
Nos cabeçalhos dos requests, é necessário incluir uma chave "token" cujo valor seja um token de API.
Criação
Cria uma nova fila.
| Endpoint | /api/v1/queues |
|---|
| Method | POST |
|---|
Parâmetros
Corpo em JSON
| name | obrigatório | Nome humanamente legível da fila. |
|---|
| slug | opcional | Forma única e amigável a URLs do nome, escrito em minúsculo, sem caracteres especiais e com espaços substituídos por underscore. Por padrão o próprio sistema tentará arranjar um slug para o nome (e pode falhar caso já exista). |
|---|
| number | obrigatório | Número na telefonia pelo qual a fila atenderá. |
|---|
| public_number | opcional | Um DID já existente pelo qual a fila atenderá publicamente – se esse DID não existir, uma criação manual terá de ser feita. |
|---|
Exemplos de retorno
| 201 | {
"meta": {
"status": 200,
"message": "Created"
},
"data": {
"id": 42
}
} |
|---|
| 400 | {
"meta": {
"status": 400,
"message": "Missing required params"
}
} |
|---|
| 500 | {
"meta": {
"status": 500,
"message": "Data insertion may break a database constraint"
}
} |
|---|
Leitura de muitos
Recupera uma lista de filas.
| Endpoint | /api/v1/queues |
|---|
| Method | GET |
|---|
Parâmetros
Query na URL
| include_archived | opcional | Se for igual a "true" irá incluir filas arquivadas |
|---|
Exemplos de retorno
| 200 | {
"meta": {
"status": 200,
"message": "Created"
},
"data": [
{
"id": 42,
"name": "Do not panic",
"slug": "do_not_panic",
"number": "1234",
"public_number": null
},
{
"id": 24,
"name": "Expresso 2222",
"slug": "expresso_2222",
"number": "2222",
"public_number": "2222"
}
]
} |
|---|
Leitura individual
Recupera um única fila.
| Endpoint | /api/v1/queues/{queue_id} |
|---|
| Method | GET |
|---|
Parâmetros
No endpoint da URL
| queue_id | obrigatório | Deve ser igual ao valor de um campo id de uma fila já existente. |
|---|
Query da URL
| include_archived | opcional | Se for igual a "true" irá retornar a fila mesmo que ela esteja arquivada |
|---|
Exemplos de retorno
| 200 | {
"meta": {
"status": 200,
"message": "Created"
},
"data": {
"id": 42,
"name": "Do not panic",
"slug": "do_not_panic",
"number": "1234",
"public_number": null
}
} |
|---|
| 404 | {
"meta": {
"status": 404,
"message": "Queue not found"
}
} |
|---|
| 422 | {
"meta": {
"status": 422,
"message": "Queue archived not requested"
}
} |
|---|
Edição
Recupera uma lista de filas.
| Endpoint | /api/v1/queues/{queue_id} |
|---|
| Method | PUT |
|---|
Parâmetros
No endpoint da URL
| queue_id | obrigatório | Deve ser igual ao valor de um campo id de uma fila já existente. |
|---|
| name | opcional | Nome humanamente legível da fila. |
|---|
| number | opcional | Número na telefonia pelo qual a fila atenderá. |
|---|
| public_number | opcional | Um DID já existente pelo qual a fila atenderá publicamente – se esse DID não existir, uma criação manual terá de ser feita. |
|---|
| max_wait_time | opcional | Máximo tempo de espera, em segundos, em que um ligador fica aguardando ser direcionado a um agente naquela fila. |
|---|
Exemplo de Requisição
| 200 | {
"meta": {
"status": 200,
"message": "Updated"
}
} |
|---|
|
|
|---|
|
|
|---|
|
|
|---|
Exemplos de retorno
| 200 | {
"meta": {
"status": 200,
"message": "Updated"
}
} |
|---|
| 400 | {
"meta": {
"status": 400,
"message": "Missing fields or trying to update slug"
}
} |
|---|
| 404 | {
"meta": {
"status": 404,
"message": "Queue not found"
}
} |
|---|
| 422 | {
"meta": {
"status": 422,
"message": "Archived queue can not be edited"
}
} |
|---|
Arquivamento
Arquiva uma fila, tornando-a indiponível para ser habilitada e sua consulta fica parcialmente restringida.
| Endpoint | /api/v1/queues/{queue_id} |
|---|
| Method | DELETE |
|---|
Parâmetros
No endpoint da URL
| queue_id | obrigatório | Deve ser igual ao valor de um campo id de uma fila já existente. |
|---|
Exemplos de retorno
| 200 | {
"meta": {
"status": 200,
"message": "Arquived"
}
} |
|---|
| 404 | {
"meta": {
"status": 404,
"message": "Queue not found"
}
} |
|---|
| 422 | {
"meta": {
"status": 422,
"message": "Enabled queue can not be archived"
}
} |
|---|
Listar pausas
| Endpoint | /api/v1/queues/{queue_id}/pauses |
|---|
| Method | GET |
|---|
Query String
| Nome | Valor Padrão | Valor Máximo |
|---|
| limit | 50 | 50 |
| page | 1 | - |
Exemplo de requisição
curl -X POST \
https://example.evolux.net.br/api/v1/queues/1/pauses?page=1&limit=2 \
-H 'Content-Type: application/json' \
-H 'token: <EVOLUX_TOKEN>'
Exemplo de respostas
{
"pagination": {
"max_limit": 50,
"limit": 50,
"first_url": "https://example.evolux.net.br/api/v1/queues/1/pauses?page=1",
"next_url": null,
"items": 2,
"last_url": "https://example.evolux.net.br/api/v1/queues/1/pauses?page=1",
"total": 2,
"current_url": "https://example.evolux.net.br/api/v1/queues/1/pauses?page=1",
"prev_url": null
},
"meta": {
"status": 200,
"message": "OK"
},
"data": [
{
"automatic_unpause": false,
"limit_duration": 600,
"pause": {
"system": false,
"productive": true,
"type": "nr17rest10",
"id": 1,
"description": "10 minutos/NR17"
},
"id": 3,
"disable_unpause": false
},
{
"automatic_unpause": false,
"limit_duration": 3600,
"pause": {
"system": false,
"productive": false,
"type": null,
"id": 2,
"description": "Almoço"
},
"id": 4,
"disable_unpause": false
}
]
}