Saldo de crédito – especificação

URL da API

O URL utilizado para enviar os pedidos HTTP:

https://portal.bulkgate.com/api/1.0/simple/info

Nota

Se o pedido não chegar ao destino, repita-o no servidor de reserva backup1.bulkgate.com.

Métodos HTTP suportados

GET
POST - application/x-www-form-urlencoded
POST - application/json

Consulte os métodos do pedido para ver exemplos de cada um.

Tabela de parâmetros

NOME DO PARÂMETRO	VALOR	OBRIGATÓRIO	VALOR PREDEFINIDO
application_id	Identificador da aplicação	Sim	-
application_token	Token de autenticação da aplicação	Sim	-
wallet	Identificador da carteira cujo saldo pretende consultar. Sem ele, é devolvida a carteira predefinida da conta.	Não	-

Exemplo de pedido

POST /api/1.0/simple/info HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj" }

Resposta

Em caso de sucesso:

{ "data": { "wallet": "bg1805151838000001", "credit": 215.8138, "currency": "credits", "free_messages": 51, "datetime": "2018-06-13T09:57:21+02:00" } }

Em caso de erro:

{ "type": "unknown_identity", "code": 401, "error": "Unknown identity / unauthorized / empty application_id", "detail": null }

Em que:

type e error (descrição do erro) encontram-se na tabela de tipos de erro
code representa o erro HTTP
detail é uma informação adicional sobre o erro

Esta página foi útil?

Perguntar à IA Copiado