Flujo de peticiones

Owned by Marta Villar
Last updated: May 17, 2022
4 min read

En este documento se va 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 Pro.

Se recomienda tener abierto el documento Peticiones, para más información y ejemplos acerca de cada una de las peticiones.

Flujo de peticiones para contactos

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 Grupo 10. 1

Al realizar esta petición, obtendremos un token de acceso válido que deberemos utilizar en el resto de peticiones. 2

Esta acción se debe realizar diariamente, para asegurar tener siempre activo un token de acceso

En caso de utilizar Swagger para las peticiones, el token se debe registrar en la parte de autenticación:

  1. - Pulsamos en el botón “Authorize”, situado en la parte superior izquierda:

Autenticación en Swagger

2.- Introducimos en el cuadro de texto Bearer seguido del token que hemos obtenido y pulsamos “Authorize”:

No olvidar Bearer en el cuadro de texto ya que identifica el tipo de autenticación a utilizar

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 3 . Esta petición nos devolverá una lista de contactos que cumplen con los filtros de búsqueda. 4

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. 5 Esta petición nos devolverá el identificador del contacto nuevo o, en caso de existir, el identificador del contacto existente. 6

Una vez tenemos el identificador del contacto, podemos realizar la petición [GET] /contactos/{id} 7 para obtener la información acerca del contacto. 8

Una vez localizado éste, podemos realizar peticiones sobre sus domicilios:

  • Realizamos la petición [GET] /contactos/{id}/domicilios 9 para obtener los domicilios asociados a ese contacto. 10

  • Si no tiene domicilios, podemos crear uno nuevo para ese contacto [POST] /contactos/{id}/domicilios. 11 Esta petición nos devolverá el identificador del domicilio creado. 12

  • También podemos modificar información de un domicilio en concreto, pasando el identificador del que queremos cambiar y el identificador del contacto al que pertenece: [PUT] /contactos/{id}/domicilios/{idDomicilio}. 13

Además, podemos realizar peticiones sobre los titulares asociados a ese contacto:

  • Realizamos la petición [GET] /contactos/{id}/titulares 15 para obtener los titulares asociados a ese cliente.

  • Si no tiene titulares, podemos crear un titular nuevo para ese contacto con la petición [POST] /contactos/{id}/titulares 17 . Esta petición nos devolverá el identificador del titular creado o existente. 18

Una vez claro acerca de qué 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 14 que devuelve un listado con los expedientes que cumplen con esos filtros de búsqueda. 15

En caso de no existir el expediente, podemos crear uno nuevo asociado a un contacto con la llamada [POST] /expedientes. 16 Esta petición nos devolverá el identificador del expediente que acabamos de crear o, en caso de existir, el identificador del expediente existente. 17

Una vez tenemos el identificador del expediente, podemos realizar la petición [GET] /expedientes/{id} 18 para obtener la información acerca del mismo. 19

A continuación, podemos realizar modificaciones sobre el mismo (darlo de baja, cambiar su denominación…) con la petición [PUT] /expedientes/{id} 20

Además, podemos realizar peticiones sobre los titulares asociados a ese expediente:

  • Realizamos la petición [GET] /expedientes/{id}/titulares 22 para obtener los titulares asociados a ese expediente.

  • Si no tiene titulares, podemos crear un titular nuevo para ese expediente con la petición [POST] /expedientes/{id}/titulares 24 . Esta petición nos devolverá el identificador del titular creado o existente. 25

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, 26 que nos devolverá un listado con todos los actos que cumplen con los filtros de búsqueda. 27