Busqueda

Categorias

Consulta de menú

Por toroalbert


Publicado el 13 de Marzo del 2023


Este POST te permitirá consultar los datos de cualquier menú creado utilizando su alias como referencia dentro de la URL a la que se consulta.

Endpoint

GET https://shortae.com/api/{alias-de-menu}

Parámetros

  • u (obligatorio): Token de usuario utilizado para autenticar la solicitud, que se envía mediante autenticación básica (-u) en el comando curl.
  • access_token (obligatorio): Token de acceso necesario para la solicitud, que se envía como un parámetro mediante el comando curl.
  • XML (opcional): Si se agrega esta variable a la consulta, en vez de recibir la respuesta en formato JSON, se recibirá en formato XML.
  • debug (opcional): Si se agrega esta variable a la consulta, se imprimirá la respuesta usando la función var_dump(), para ayudar en la depuración del código.
  • search (opcional): Si se utiliza esta variable, se buscará en los datos del menú para asegurarse de que contenga lo indicado.
  • UserApi (opcional): Si se utiliza esta variable, se puede evitar enviar el usuario en la autenticación con la opción -u del comando curl.
  • PasswordApi (opcional): Si se utiliza esta variable, se puede evitar enviar la contraseña en la autenticación con la opción -u del comando curl.
  • orden y order (opcional): Ambas variables son por defecto ascendentes "ASC". Si se envía DESC, la consulta será descendente.
  • aordenar y orderby (opcional): Se utilizan para señalar el campo del menú por el cual se desea ordenar la consulta.
  • desde y limite (opcional): Se utilizan para la paginación de los resultados. Limite indica cuántos datos tendrá la respuesta y desde indica el inicio de la consulta.

Todas estas variables pueden ser enviadas tanto por GET como por POST.

Respuesta

La respuesta es un objeto JSON con las siguientes claves:

  • success: Indica si la solicitud tuvo éxito.
  • answer: Contiene los datos del menú consultado.

Ejemplo

curl -X GET 'https://shortae.com/api/{alias-de-menu}?XML&search=valor-buscado&orden=DESC&aordenar=nombre-campo&limite=10&desde=20' \ -u "{token-de-usuario}:" \ -d access_token="Your access_token"

Es importante que adaptes este ejemplo a tu API específica, incluyendo el alias de menú y los parámetros necesarios. Además, recuerda que debes incluir el token de acceso (access_token) en la consulta, el cual se obtiene utilizando la función Authentication del API.