Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

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
MethodPOST

Parâmetros

Corpo em JSON

nameobrigatórioNome humanamente legível da fila.
slugopcional

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).

numberobrigatórioNúmero na telefonia pelo qual a fila atenderá.
public_numberopcional

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
MethodGET

Parâmetros

Query na URL

include_archivedopcionalSe 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}
MethodGET

Parâmetros

No endpoint da URL

queue_idobrigatórioDeve ser igual ao valor de um campo id de uma fila já existente.

Query da URL

include_archivedopcionalSe 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}
MethodPUT

Parâmetros

No endpoint da URL

queue_idobrigatórioDeve ser igual ao valor de um campo id de uma fila já existente.

Corpo em JSON

nameopcionalNome humanamente legível da fila.
numberopcionalNúmero na telefonia pelo qual a fila atenderá.
public_numberopcional

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_timeopcional

Máximo tempo de espera, em segundos, em que um ligador fica aguardando ser

direcionado a um agente naquela fila.

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}
MethodDELETE

Parâmetros

No endpoint da URL

queue_idobrigatórioDeve 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
MethodGET

Query String

NomeValor PadrãoValor Máximo
limit5050
page1-


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
        }
    ]
}



  • No labels