Skip to main content
Version: 1.x(Legacy)

Webhook Autenticacion de Operadores

Autenticación de los proveedores para el uso del WebHook Proveedores AveOnline

Request 🚀​

url​

https://aveonline.co/api/hooks/autenticar.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "autenticar"
  • data* Object -> {} Datos relevantes para la Autenticación
    • id_empresa* Number Número identificador del Proveedor
    • razon* String Intención explícita del WebHook, "actualizarguias"

Ejemplo​

{
  
    "tipo": "autenticar",
    "data" : {
        "id_empresa": "ID",
        "razon": "actualizarguias"      
    }
}

Response 📄​

Success​

StatusCode: 200
  • status : String
  • tiempo_inicial : String Respuesta en DateTime para facilitar el uso del token
  • vencimiento : String Respuesta en DateTime para facilitar el vencimiento del token
  • token : String Token formato Basic

Ejemplo​

{
    "status": "ok",
    "tiempo_inicial": "2022-03-11 20:22:23",
    "vencimiento": "2022-03-11 21:22:23",
    "token": "xxxxxxxxxxxxx.xxxxxxxxxxxxx.xxxxxxxxxxxxxxxxx"
}

!RECOMENDACIONES!​

  • La vida útil del token por defecto va a ser de 8 HORAS.
  • NO se requiere! que para cada petición, se necesite un nuevo token.
  • Verifica que el token este vigente, en la respuesta se facilita esa información.
  • Si el token esta vencido se retorna { "status": "error", "message":"Token no valido" }.
  • Y más importante, se reservo el StatusCode: 401, para el vencimiento del token.
  • Cambios y sugerencias: desarrollo2@aveonline.co, desarrollo3@aveonline.co.

Error​

StatusCode: 400...
  • status : String error
  • message : String Mensaje descriptivo del error
{
    "status": "error",
    "message": "verifique su ID y vuelva a intentar"
}