En este documento se van a realizar un ciclo completo por todas las peticiones. Este ciclo irá, desde el método de acceso a la API, hasta la modificación de un campo de alguna de las entidades de Apiges.
Info |
---|
Se recomienda tener abierto el documento Peticiones para más información y ejemplos acerca de cada una de las peticiones. |
Image Added
En primer lugar, debemos autenticarnos para poder utilizar la API. Para ello, vamos a realizar la petición [GET] /login con usuario y contraseña facilitados por Grupo10
Al realizar esta petición, obtendremos un token de acceso válido que deberemos utilizar en el resto de peticiones.
Note |
---|
Esta acción se debe realizar diariamente para asegurar tener siempre activo un token de acceso |
Una vez autenticados, vamos a comenzar con las peticiones de Contactos.
Podemos empezar buscando un contacto en concreto en base a sus características (apellidos, código, tipo de contacto…) . Para ello, realizaremos una petición a [POST] /contactos/search
. Esta petición, nos devolverá una lista de contactos que cumplen con los filtros de búsqueda. Si en esta lista, el contacto no existe, podemos dar de alta en el sistema un nuevo contacto nuevo utilizando la petición [POST] /contactos.
Esta petición nos devolverá el identificador del contacto nuevo ó, en caso de existir, el identificador del contacto existente. Una vez tenemos el identificador del contacto, podemos realizar la petición [GET] /contactos/{id}
para obtener la información acerca del contacto. Una vez localizado el contacto, podemos realizar peticiones sobre sus domicilios:
Realizamos la petición [GET] /contactos/{id}/domicilios
para obtener los domicilios asociados a ese contacto. Si no tiene domicilios, podemos crear uno nuevo para ese contacto [POST] /contactos/{id}/domicilios
. Esta petición nos devolverá el identificador del domicilio creado. También, podemos modificar información de un domicilio en concreto pasando el identificador del domicilio que queremos modificar y el identificador del contacto al que pertenece: [PUT] /contactos/{id}/domicilios/{idDomicilio}
Una vez claro acerca de que podemos hacer el bloque de contactos, vamos a pasar al bloque de Expedientes.
...
En este bloque, de igual forma, podemos empezar buscando el expediente filtrando por alguna de sus características (modalidad, número o país). Para ello, vamos a realizar la petición [POST] /expedientes/search
que devuelve un listado con los expedientes que cumplen con esos filtros de búsqueda. En caso de no existir el expediente podemos crear uno nuevo asociado a un contacto con la llamada [POST] /expedientes.
Esta petición nos devolverá el identificador del expediente que acabamos de crear ó, en caso de existir, el identificador del expediente existente. Una vez tenemos el identificador del expediente, podemos realizar la petición [GET] /expedientes/{id}
para obtener la información acerca del expediente. Una vez localizado el expediente, podemos realizar modificaciones sobre el mismo (darlo de baja, cambiar su denominación…) con la petición [PUT] /expedientes/{id}
Por último, sería interesante poder realizar una búsqueda de los actos que corresponden a una fecha en concreto o bien entre dos rangos de fechas. Para ello, utilizamos la petición [POST] /expedientes/actos/search
que nos devolverá un listado con todos los actos que cumplen con los filtros de búsqueda.