Que Qué es Colppy REST API?
REST es un estilo de arquitectura diseñada para aplicaciones Web's. La idea es de en vez de usar mecanismos complicados como SOAP para conexion entre computadoras, Simplemente usamos el protocolo HTTP API de Colppy utiliza el protocolo HTTPS para hacer las pegadas entre maquinasa la API. Colppy REST API permite mediante una solicitud en formato json; iniciar sesión, realizar altas y bajas de facturas, leer datos de empresas o cliente entre otras funcionalidades.
Como Cómo empiezo?
El primer paso para empezar a desarrollar es registrar usuario y contraseña en la Web de desarrolladores de Colppy. Después para Para realizar una petición podemos o generar un script en php que utilice CUrl Curl o utilizando alguna herramienta que puedan ejecutar HTTP POST Request (Por ej. httprequester para Firefox ò o PostMan para Chrome).
Como Cómo realizo una petición?
La url de Colppy REST API para realizar pruebas es http://staging.colppy.com/lib/frontera2/service.php. El punto de acceso a Colppy API en su versión Producción es https://login.colppy.com/lib/frontera2/service.php. Para poder generar una petición debemos ejecutar HTTP POST Request a una de las urls en donde se encuentra el servicios, ya sea de produccion o testing con JSON que tiene el siguiente formato:
...
En auth van tus credenciales, con las que te registraste en la web de desarrolladores de colppyColppy, tu usuario de colppy Colppy y el MD5 de la contraseña que utilizaste para registraste. por Por ejemplo si mi nombre usuario como desarrollador es SujetoDePrueba y mi contraseña SujetoDePruebaContraseña, el JSON quedaría de la siguiente forma:
...
En service se especifica que es lo que deseo hacer con en la petición. Cada una alta, baja y modificación de colppy están en diferentes Provisiones y cada una de estas en diferentes operaciones. La Provisiones hacen referencia sobre cual de los modulo módulo Colppy yo deseo trabajar, y la operacion operación hace referencia a lo que deseo hacer con ese modulomódulo. Existe un Indice Índice con las distintas Provisiones y Operaciones que soporta Colppy. Por ejemplo si lo que quiero hacer es iniciar sesion sesión en Colppy lo que tengo que hacer es modificar el campo provision con el nombre del modulo al que quiero acceder en este caso Usuario, luego me fijo en el indice índice de provisiones y operaciones de colppy Colppy y verifico que exista la operaciones iniciar_sesion, Entonces en el campo operaciones lo cambio a iniciar_sesion. Entonces el JSON quedaría de la siguiente manera
{...
"service": {"provision": "Usuario","operacion": "iniciar_sesion"},
...
}
Una cosas con la que hay que tener mucho cuidado es que NOTA importante sobre el nombre de las provisiones y operaciones son sensible a mayúsculas. Siempre tener el Indice índice de provisiones y operaciones a mano. En parameters van los parametros que espera la operacion para poderse ejecutar. Estos parámetros varían de provision provisión en provision y de operacion operación en operacion. En este caso estamos tratando de iniciar sesion en colppyColppy, si nos fijamos en el indice índice de provisiones y operaciones en la seccion sección de la provision provisión sesion, podemos ver los parametros parámetros que espera la operacion operación en el JSON.
En el nuestro ejemplo el JSON final quedaría de la siguiente manera:
...
{"auth": {"usuario": "SujetoDePrueba","password": "SujetoDePruebaContraseña"},"service": {"provision": "Usuario","operacion": "iniciar_sesion"},"parameters": {"sesion": {"usuario": "UsuarioTest","claveSesion": "ContraseñaTest"},}
}
Una vez que ejecutamos la HTTP POST Request con nuestro JSON, Colppy REST API nos va a responder con un mensaje informándonos si el requerimiento se realizo realizó con éxito o no.
Ejemplo de una respuesta de éxito:
...