Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga do conteúdo. Ver a versão atual.

Comparar com o atual Exibir histórico da versão

« Anterior Versão 15 Próxima »

/voz/status

Método que retorna status da chamadas realizadas pela API de voz da Directcall.

 

 

DESCRIÇÃO

Com este método podemos consultar uma chamada que está em andamento

ESTRUTURA DA URL

https://api.directcallsoft.com/voz/status

VERSÃO

1

MÉTODO

GET

PARÂMETROS

origem obrigatório Número que está solicitando a ligação, formato exemplo: 554130600300 (DDI DDD NUMERO)

destino obrigatório Número de destino da chamada, formato exemplo: 554130600300 (DDI DDD NUMERO)

access_token obrigatório Chave de acesso ao método. Para saber como obter, clique aqui

format opcional Opção de retorno da API podendo ser JSON ou XML (se não informado, JSON será o padrão)

RETORNO

api Origem API que está sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

msg Array de resposta da API

Exemplo de resposta em JSON
{
   "api":"voz",
   "modulo":"status",
   "status":"ok",
   "codigo":"000",
   "msg":[
      {
         "telefone":" 55 41  3017 5726",
         "status":"atendida",
         "inicio":"2013-02-21 18:28:14",
         "duracao":"00:00:00"
      }
   ]
}

Exemplos:

Linguagem

Descrição

Arquivo

PHP

Arquivo em PHP com exemplo de como requisitar o access_token por meio da API

RequisitarToken.php

PHP

Arquivo em PHP com exemplo de como consultar status de uma chamada em andamento via API

ConsultaStatusChamada.php

Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.

  • Sem rótulos