La API REST de FacturaScripts

La API nos ofrece una forma sencilla de comunicar con los recursos disponibles, mediante unos métodos concretos y simples a los que podemos denominar en su conjunto como CRUD, por su acrónimo en inglés:

• POST: Crear (Create) un elemento nuevo.
• GET: Leer (Read) una lista de elementos o un elemento, en listados con paginación, filtros y/o ordenación, o elementos concretos. Este es el método que se utiliza por defecto.
• PUT: Actualizar (Update) un elemento concreto.
• DELETE: Eliminar (Delete) un elemento concreto.

¿Cómo usarla?

Para acceder a la API de FacturaScripts, añade /api al final de la url donde tengas FacturaScripts. Para este ejemplo, como tengo instalado FacturaScripts en localhost:8000, la url de la API es: http://localhost:8000/api

Para simplificar los ejemplos a continuación se va a utilizar Insomnia para realizar las consultas contra la API y recibir una respuesta formateada que sea más legible.

Autenticación con la API

Para usar la API primero debemos activarla, crear una clave y darle unos permisos:

• Para activar la API basta con dirigirse al menú administrador, panel de control, apartado Por defecto. Una vez ahí marcamos la opción de Activar API y pulsamos Guardar.
• Ahora hacemos clic en la sección API Keys, pulsamos el botón nuevo y creamos una nueva clave con la casilla "acceso completo" marcada.

Bien, ahora ya podemos conectar:

• Abrimos insomnia.
• Introducimos la url de la API, en este caso http://localhost:8000/api
• Nos vamos a la pestaña header y añadimos el campo Token con nuestra clave de API como valor.

API-VERSION-NOT-FOUND

• Este error indica que no hemos seleccionado la versión de la API.
• La API está diseñada para soportar múltiples versiones, aunque por ahora solamente usaremos la versión 3.
• La url de la versión 3 es: http://localhost:8000/api/3

En el apartado resources tenemos todos los recursos o endpoints accesibles a través de la API.