Que 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 para hacer las pegadas entre maquinas. 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.
Como empiezo?
El primer paso para empezar a desarrollar es registrar usuario y contraseña en la Web de desarrolladores de Colppy. Después para realizar una petición podemos o generar un script en php que utilice CUrl o utilizando alguna herramienta que puedan ejecutar HTTP POST Request (Por ej. httprequester para Firefox ò PostMan para Chrome).
Como 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:
{"auth": {"usuario": "USUARIO_API","password": "USUARIO_PASSWORD"},"service": {"provision": "Nombre_del_Provisión","operacion": "Nombre_de_la_operación"},"parameters": {"sesion": {"usuario": "UsuariodeColppy","claveSesion": "ContraseñaDeColppy"},"otros parametros": {}}
}
El JSON se divide en tres partes auth, service y parameters.
En auth van tus credenciales, con las que te registraste en la web de desarrolladores de colppy, tu usuario de colppy y el MD5 de la contraseña que utilizaste para registraste. por ejemplo si mi nombre usuario como desarrollador es SujetoDePrueba y mi contraseña SujetoDePruebaContraseña, el JSON quedaría de la siguiente forma:
{"auth": {"usuario": "SujetoDePrueba","password": "d0edfe89f30a78ef45ab9a22bd0f826b"},....}
El md5 de la cadena "SujetoDePruebaContraseña" es la cadena "d0edfe89f30a78ef45ab9a22bd0f826b".
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 Colppy yo deseo trabajar, y la operacion hace referencia a lo que deseo hacer con ese modulo. Existe un Indice con las distintas Provisiones y Operaciones que soporta Colppy. Por ejemplo si lo que quiero hacer es iniciar sesion 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 de provisiones y operaciones de 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 el nombre de las provisiones y operaciones son sensible a mayúsculas. Siempre tener el Indice 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 en provision y de operacion en operacion. En este caso estamos tratando de iniciar sesion en colppy, si nos fijamos en el indice de provisiones y operaciones en la seccion de la provision sesion, podemos ver los parametros que espera la operacion 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"},}
}