In this document we can learn how to access to SOAP Service through the API Manager

1. Emmerson Miranda
Blog: http://www.emmersonmiranda.net

2. • Los objetivos de este documento son:
– Hacer accesible un servicio SOAP desde WSO2 API Manager y
establecer un consumo de 150 transacciones por minuto como máximo.
– Crear y utilizar un nuevo “Throttling tier” (cuota de uso)
– Creación, publicación, suscripción y test del API
– Anuncio de la nueva API en las redes sociales
– Revisión de las estadísticas del API Manager
• Requisitos
– Haber creado el DataService Countries
http://www.emmersonmiranda.net/2015/08/wso2-dss-creacion-de-un-
dataservice.html

4. • Los “Throttling tiers” definen límites de uso (cuotas de consumo) para un
API, por defecto el producto trae los siguientes tipos:
– Unlimited .- Se puede invocar muchas veces
– Gold .- 20 peticiones por minuto
– Silver .- 5 peticiones por minuto
– Bronce .- 1 petición por minuto
• Pero por ejemplo, si tuviéramos un requerimiento de soportar 150
transacciones por minuto (TPM), tendríamos que registrar una nueva en el
fichero tiers.xml

5. • Editamos el fichero tiers.xml y registramos la nueva cuota.

6. • Extracto del nuevo registro visto anteriormente, en este se especifica 150
transacciones por minuto (TPM)
<wsp:Policy>
<throttle:ID throttle:type="ROLE">TPM_150</throttle:ID>
<wsp:Policy>
<throttle:Control>
<wsp:Policy>
<throttle:MaximumCount>150</throttle:MaximumCount>
<throttle:UnitTime>60000</throttle:UnitTime>
</wsp:Policy>
</throttle:Control>
</wsp:Policy>
</wsp:Policy>

8. • Copiamos la dirección del servicio SOAP (DataService Countries)

9. • Accedemos al Publisher con la cuenta de un usuario creador de API
https://servidor:9445/publisher

10. • Iniciamos el wizard
de creación,
indicamos que el
servicio es del tipo
SOAP y pegamos
la dirección del
WSDL copiada
previamente y
presionamos “Start
Creating”.

11. • Especificamos los
datos de publicación y
presionamos el botón
“Test URI” para validar
que el servicio este
bien especificado,
luego continuamos
presionando “Next
Implement”.

12. • Luego indicamos los endpoints para producción y para el entorno sandbox

13. • Finalmente terminamos especificando el límite de consumo que hemos
creado al inicio.

14. • Ahora podemos ver que aparece la API Countries.

16. • Accedemos al Publisher con la cuenta de un usuario con permisos de
publicación del API https://servidor:9445/publisher

17. • En el listado de las APIs seleccionamos el API a publicar (Countries)

18. • En la pestaña “Lifecycle” cambiamos el estado del API de “CREATED” a
“PUBLISHED” y actualizamos el API.

20. • Una vez publicado el API, acudimos al Store para suscribirnos
https://server:9445/store/

21. • Seleccionamos “Countries”

22. • Seleccionamos la aplicación en la cual queremos suscribirnos y el tier a
aplicar.

23. • En la pantalla de
suscripción
generamos las claves
y copiamos el “Access
Token”

25. • Desde la pestaña de “Overview” del API Countries en el API Store,
descargamos el WSDL que publica.

26. • Ahora abrimos el SOAPUI y creamos un nuevo proyecto utilizando el WSDL
descargado previamente.

27. • Crearemos una request y al invocar el servicio recibiremos un error de
autenticación, y esto es porque no se esta especificando el “Access Token”
generado al momento de la suscripción.

28. • Para invocar correctamente el servicio hay que crear la cabecera
“Authorization” e pasar el token generado añadiendo el texto “Bearer ”
como prefijo del token.

30. • La propia pestaña de “Overview”,
nos permite anunciar la
disponibilidad de nuestra nueva
API a nuestros followers en redes
sociales como Twitter o Facebook.
• En la siguiente slide veremos el
caso de Twitter.

31. • Antes de publicar por ejemplo en Twitter, podemos editar el contenido del
tweet.

33. • Desde la consola del Publisher se puede ver las estadísticas de nuestra
API.

35. • https://docs.wso2.com/display/AM170/Adding+New+Throttling+Tiers
• https://docs.wso2.com/display/AM170/Quick+Start+Guide
• https://docs.wso2.com/display/AM170/Managing+Throttling+Tiers