Reenvio de código de utilização única (OTP)

URL da API

URL utilizado para enviar pedidos HTTP:

https://portal.bulkgate.com/api/1.0/otp/resend

Nota

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

Métodos HTTP suportados

POST - application/json

POST /api/1.0/otp/resend HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Importante

Dois reenvios do mesmo pedido têm de estar separados por 60 segundos. Uma tentativa antecipada devolve the_quota_of_one_additional_resend_per_minute_has_been_exceeded. O número de reenvios é ainda limitado por trials_available_resend do pedido SEND.

Tabela de parâmetros

NOME DO PARÂMETRO	VALOR	OBRIGATÓRIO	VALOR PREDEFINIDO
application_id	ID da aplicação	Sim	-
application_token	Token da aplicação	Sim	-
id	ID recebido ao enviar o código de utilização única	Sim	-

Exemplo de pedido

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

Resposta

Em caso de sucesso:

{ "data": { "id": "otp-65cca8b4b6a6a2.24308291", "message": { "status": "accepted", "message_id": "cascade-xjyjzh7thor3", "part_id": [ "cascade-xjyjzh7thor3" ], "number": "420777777777", "channel": "whatsapp" } } }

Em caso de erro:

{ "type": "invalid_id_provided", "code": 400, "error": "Invalid id provided", "detail": null }

{ "type": "unknown_identity", "code": 400, "error": "Unknown identity", "detail": null }

{ "type": "invalid_input_parameters", "code": 400, "error": "Invalid input parameters", "detail": null }

Em que:

type e error (descrição do erro) encontram-se na tabela de tipos de erros
code representa o código de erro HTTP
detail contém informações adicionais sobre o erro

Esta página foi útil?

Perguntar à IA Copiado