POST /api/assignDid/API_TOKEN/API_KEY |
Este Ponto de Acesso irá permitir que você vincule um Número Entrante (DID) existente para um Assinante.
Com esta API, você poderá realizar a listagem de números entrantes (DID) e exibir em seu App, seu cliente escolherá um produto e já vinculará automaticamente a ele, tornando o processo de compra de DIDs completamente automatizado.
Para nosso exemplo, iremos deduzir que o endereço do servidor será sip.nextbilling.com.br. Nesse caso, o endereço da API seria:
POST https://sip.nextbilling.com.br/api/assignDid/API_TOKEN/API_KEY
|
A chamada para obter os dados da consulta, é realizado utilizando um HTTP GET para o endereço de consumo da API. Um exemplo de chamada a essa API seria:
$ curl -X POST -d '{"id": 1, "customer_id": 23}' 'https://sip.nextbilling.com.br/api/assignDid/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629' |
Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
{ "error":0, "reason":"OK", "did_id":1, "description":"DID Number (11) 3090-0077", "record_status":1, "did_status":1 } |
Campo | Descrição |
---|---|
error | 1 em caso de erro |
reason | Descrição caso tenha ocorrido algum erro |
did_id | ID do Número Entrante |
description | Descrição do DID |
record_status | Status do DID na Plataforma |
did_status | 0 - DISPONÍVEL | 1 - VENDIDO |