Skip to content

Primera petición al API

jose edited this page Jul 17, 2018 · 7 revisions

Primera petición al API

Las Peticiones al API se realizan usando el URL con nombre de dominio o IP donde esté instalado, en este ejemplo vamos a usar API que se encuentra en demo en CRLibre.org en el dominio api-demo.crlibre.org y con ruta /api.php

El URL es https://api-demo.crlibre.org/api.php

Para el uso del API tenemos que enviar un conjunto de clave y valor en el formato key=Value

Para nuestra primera prueba se va a llamar a una función de ejemplo en el módulo llamado ejemplo

Este módulo se llama ejemplo, dentro de module.php existe un arreglo con rutas, esas rutas hacen referencia a funciones ubicadas ya sea en el mismo archivo php o en un archivo aparte de extensión .php, esto lo veremos a profundidad más adelante, ahorita nos enfocaremos en el método hola

Para realizar esta prueba vamos a enviarle al API 2 parámetros:

  • w es el nombre del módulo (mismo que el nombre del directorio)
  • r es el método que ejecutará dentro del archivo module.php

Prueba desde Navegador

https://api-demo.crlibre.org/api.php?w=ejemplo&r=hola

Esto nos va a retornar un saludo desde el módulo hola :)

Desde línea de comandos

  • GET usando curl
curl -w '\n' -X GET --url "https://api-demo.crlibre.org/api.php?w=ejemplo&r=hola"
  • POST usando curl
$ curl --request POST \
  --url https://api-demo.crlibre.org/api.php \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data "w=ejemplo&r=hola"
{"resp":"hola :)"}
  • POST con wget
wget --quiet \
  --method POST \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --body-data "w=ejemplo&r=hola" \
  --output-document - \
  https://api-demo.crlibre.org/api.php