API OTP

A API OTP pode ser usada para gerar e validar PINs em campanhas VAS, garantindo autenticação de usuário segura e eficiente.

Parâmetros Comuns

Query	Tipo	Descrição
key	String	Chave da API
aid	Inteiro	Id do Afiliado
mid	Inteiro	Seu MID de Anunciante

Gerar OTP

POST https://api.offer18.com/api/af/otp_gen

Parâmetros da Requisição

Corpo	Tipo	Descrição
type	string	Tipo de requisição
userId	string	ID do usuário (sob o Parceiro)
msisdn	string	Número móvel (numérico)
partner	string	Nome do parceiro

https://api.offer18.com/api/af/otp_gen?key=000000000&aid=0000&mid=0000&msisdn=xxxxxxxx&partner=partnername&userId=xxxx

Sucesso

{
  "status": "200",
  "response": "otp_sent",
  "data": "6xxxxx00f3fa55axxxxxxxxxx567a" // data[requestId] key and value return when patner api return in response 
} 

Falha

{     
  "status": "400",     
  "error": "invalid_user_credentials" 
}

---

Verificar OTP

POST https://api.offer18.com/api/af/otp_verify

Parâmetros da Requisição

Corpo	Tipo	Descrição
userId	string	ID do usuário
msisdn	string	Número móvel
otp	string	OTP recebido pelo usuário
partner	string	Nome do parceiro
request_id	string	ID da requisição para rastreamento

https://api.offer18.com/api/af/otp_verify?key=000000000&aid=0000&mid=0000&msisdn=xxxxxxxx&partner=partnername&userId=xxxx&request_id=xxxxx&otp=xxxxx

Resposta de API de exemplo

Sucesso

{     
  "status": "200",     
  "response": "otp_verified" 
} 

Falha

{     
  "status": "400",     
  "error": "invalid_user_credentials" 
}

---

Para interações seguras, sempre chame a API a partir do lado do servidor.