API
En este artículo se describen las peticiones necesarias para:
- Obtener token para las peticiones.
- Comprobar si existe un federado.
- Crear un federado.
- Actualizar un federado.
- Crear una licencia.
La URL del artículo es https://demo.playoffinformatica.com, en un caso real se debería utilizar la de cada cliente.
Lo primero que hay que hacer es conseguir el token, las credenciales a utilizar deben ser las de un usuario federación de la aplicación.
LOGIN
Este sería un ejemplo de petición:
y recibimos el acces_token en la respuesta, este token será necesario para las demás peticiones a realizar.
COMPROBAR SI EXISTE UN FEDERADO
Se pueden utilizar 3 campos: dni (nif), pasaporte (residencia) o tarjeta sanitaria(catsalut).
Si se recibe un código 404 significa que el federado no existe, si el federado existe se puede utilizar el "idFederat" recibido para actualizar sus datos.
CREAR FEDERADO
Si la respuesta es un código 201 significa que el federado se ha creado correctamente.
ACTUALIZAR FEDERADO
Es necesario utilizar el "idFederat" para actualizar los datos del federado
La respuesta 204 significa que la petición ha sido procesada correctamente
CREAR LICENCIA
Estos son los datos mínimos para crear la licencia:
- idFederat: identificador del federado.
- codiClubExtern: campo código del formulario del club. También se puede utilizar el identificador interno del club que corresponde a idClub.
- codiSubCat: campo código del formulario de la subcategoría. También se puede utilizar el identificador interno de la subcategoría que corresponde a idSubCategoria.
Si la licencia se ha creado correctamente se recibirá un código 201.
DOCUMENTACIÓN
En el siguiente enlace se encuentra la documentación a la API: https://apifederacions.playoffinformatica.com/