/**
@file
Documentación de ces_interop.

@defgroup ces_interop Ces Interop
@ingroup ices
@{


## ICES web services

El módulo CES Interop para el proyecto ICES viene con dos web services que
permiten a terceras aplicaciones comunicarse con el servidor del banco. Estos
dos servicios son:

- OpenTransact: Un protocolo simple para transacciones financieras.
- Resources: Un servidor JSON simple para recuperar recursos del ICES.

### OpenTransact

ICES viene con una implementación del protocolo de
[OpenTransact](www.opentransact.org). El protocolo de OpenTransact es una
extensión del protocolo de  [Oauth2](http://oauth.net/2/)  Añadiendo algunos
campos que definen las transacciones. Hay una referencia de la especificación
del protocolo en
[http://www.opentransact.org/core.html](http://www.opentransact.org/core.html) 

Hay algunas pequeñas diferencias entre ls especificación oficial y la
implementación en este módulo.


- El enlace de solicitud de transferencia no se ha aplicado debido a la facilidad para un
  atacante de proporcionar un enlace de pago que se hace con un solo clic.
  Nosotros restringimos el uso de los servicios opentransact a los clientes autorizados.

- El atributo de validez no es totalmente compatible. Lo hacemos sin el apoyo de repetir
  intervalos. No reservamos el importe por lo que la transferencia no se garantiza que
  sea aceptada en el momento de la aplicación.

El punto final del servicio, o el URI de activos en términos opentransct, es:

https://[site name]/ces/interop/opentransact/XXXX

donde XXXX es el código de la bolsa cuando la operación se lleva a cabo.

El punto final token es

https://[site name]/ces/interop/opentransact/token

Ver el ces_interop.test archivo de prueba incluidos en este módulo para un
ejemplo completo sobre el uso de este servicio.

Para utilizar el servicio de un cliente debe ser concedida con un client_id y
client_key que debe ser proporcionada por el administrador del sistema de la
instancia CIEM. Por favor póngase en contacto con http://www.integralces.net
info@integralces.net.

### Recursos

El servicio de los recursos es un simple servicio web JSON para acceder a
algunos de los objetos en el CIEM. La autorización de este servicio es
[OAuth2](http://oauth.net/2/) similar al protocolo opentransact.

El criterio de valoración es la autorización

https://[site name]/oauth2/authorize

Se requiere que el atributo scope y debe ajustarse a los recursos. El punto final token es

https://[site name]/oauth2/token

Hay tres recursos disponibles:

- https://[site name]/ces/interop/resources/user/N: where N is the identifier of the user.
- https://[site name]/ces/interop/resources/account/N: where N is the identifier of the account.
- https://[site name]/ces/interop/resources/transaction/N: where N is the identifier of the transaction.

@}
*/
