Versões comparadas

Versão Versão antiga 7 Nova versão Atual
Alterações feitas por

Leanderson Correia

Leanderson Correia

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

/numero/disponivel

DESCRIÇÃO

Este método permite listar todos os números disponíveis para contratação

ESTRUTURA DA URL

https://api.directcallsoft.com/numero/disponivel

VERSÃO

1

MÉTODO

POST

PARÂMETROS

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

num_vip opcional Filtro de número PREMIUM ou COMUM (se omitido será listado ambos).

   1 - Número Comum
   2 - Número Premium

ddd opcional Filtro de número por DDD. exemplo 41

cidade opcional Filtro de número por CIDADE. exemplo Curitiba

tipo 

tipo opcional

 Tipo

 Tipo de filtro. Se omitido, listará todos os serviços:

   29 - Linha Telefônica Virtual - BR (DID)
   40 - 0800IP A
   43 - Número Único Nacional (NUN)

pagina opcional Número da página (se omitido será mostrada a primeira página)

itens_por_pagina opcional Número de itens listados na página (se omitido será mostrado 10 itens)

  1. RETORNO

api Origem API que esta 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

data Lista com os números disponíveis

Bloco de códigofirstline1title

Exemplo de resposta em JSON
linenumberstrue
Bloco de código
{
   "api":"numero",
   "modulo":"numero",
   "status":"ok",
   "codigo":"000",
   "data":[
      {
         "id_num":"19179",
         "cd_area":"41",
         "nr_tel":"35145100",
         "nome_cidade":"CURITIBA"
      }
   ],
   "pagina_atual":1,
   "itens_por_pagina":10,
   "total_de_paginas":1,
   "total_de_registros":1
}

Exemplos:

Linguagem

Descrição

Arquivo

PHP

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

RequisitarToken.php

Informações

...

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.

Veja também: