Introducción

Esta sección de la documentación explica cómo utilizar nuestro API para realizar integraciones de desarrollos a la medida, con su información en InterFuerza.

La estructura de información es JSON, el cual es el más utilizado en los API en la actualidad. Puede conocer más sobre JSON ingresando aquí.


Token de Autenticación

Para acceder a las funciones de API, debe dar click en el menú de Configuración desde su cuenta de InterFuerza, y seleccionar la opción Apps, como lo muestra la imagen:

 


Al ingresar a la pantalla de Apps de Interfuerza, busque la opción de InterFuerza Api, y de clic en Configurar:


Al dar clic en Configurar, ingresará a nueva ventana donde accederá a toda la información necesaria para llevar a cabo sus integraciones:

El Api de InterFuerza es compatible con la version 1_1 de HTTP.

Token

Aquí se genera el token necesario para llevar a cabo sus integraciones. Inclusive, podrá regenerar su Token de ser necesario. Si regenera el Token, debe estar claro que deberá actualizar sus integraciones realizadas. Puesto que el API comenzará a denegar cualquier integración que no esté utilizando el nuevo Token.

 

Control de accesos por IP

Es de carácter obligatorio agregar en este apartado todos los IPs desde los cuales, se recibirán todos los llamados de API. Este paso es fundamental para lograr un buen funcionamiento.

 

Documentación

Acceda a todos las guías de InterFuerza API para llevar a cabo de forma exitosa sus integraciones.


Comunicación con el API

Para realizar las comunicaciones con el API la misma es con HTTPS. Toda las peticiones deben ser enviadas a la dirección:

https://app.interfuerza.com/api/

 

La misma debe llevar el siguiente encabezado o HTTP Header:

X-IFX-Token: <TokenString>

 

Donde <TokenString> es el token obtenido con anterioridad.


Clases y Acciones

Nuestro API utiliza dos variables enviadas en el contenido POST. A continuación detallamos la descripción de cada una:

 

Clases son definidos por la variable: class

 class Descripción
GET Obtener información.
PUT Guardar nueva información.
UPDATE Actualizar información existente.
DELETE Eliminar información.

Acciones son definidas por la variable:  action

La acción define la acción a ejecutar según la opción, algunos ejemplos:

 class  action Descripción
GET customers Obtiene el listado de todos los clientes.
PUT customer Crea un nuevo cliente.
UPDATE customer Actualiza una cliente.
DELETE customer Elimina un cliente.

Un ejemplo del JSON a enviar para consultar todos los clientes seria:

 {"class":"GET","action":"customers"} 

En PHP CURL sería:

Ver Código

Recuerde que remplazar el $access_token con el Token de autenticación de su empresa.


Errores

Nuestro API utiliza los errores de HTTP Status Code para reportar los errores que se encuentran en alguna ejecución. Por ejemplo, se reporta un error 400 Bad Request para reportar una acción o clase desconocida por el API.

Cualquier error será reportado con los códigos 4xx y podrán ser capturados según sea acorde.

 

Nota:
El uso del Api de InterFuerza, debe ser llevarse a cabo bajo los términos y condiciones de InterFuerza. El otorgar acceso a esta función desde su cuenta a sus usuarios, queda bajo su responsabilidad y la de los usuarios con acceso a Apps.

Puede contáctarnos a través de nuestro chat de atención al cliente para resolver cualquier duda que surja durante este proceso.

¿Fue de ayuda este artículo?