Liminal Bluevia 1

1,209 views

Published on

Liminal Bluevia 1

Published in: Education
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,209
On SlideShare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Liminal Bluevia 1

  1. 1. liminal-­‐it.com  Si  usted  quiere  desarrollar  con  Bluevia  y  Java,  esto  es  lo  primero  que  debe  saber  Campus  Party    Junio  30  de  2011    Mario  Linares  Vásquez  mario.linares@liminal-­‐it.con      
  2. 2. Bluevia  y  Java   liminal-­‐it.com  Agenda  •  Modelo  de  desarrollo  •  REST  •  OAUTH  •  SDK  para  Java  •  Documentación.  
  3. 3. Bluevia  y  Java   liminal-­‐it.com     MODELO  DE  DESARROLLO  
  4. 4. Bluevia  y  Java   liminal-­‐it.com  Bluevia   •  Un   nuevo   concepto   para   el   desarrollo   de   aplicaciones   que   consumen  servicios  en  la  red  de  telefónica,  como  mensajería   o  búsqueda  de  información  de  personas.   •  Bluevia   proporciona   un   conjunto   de   APIs   y   SDKs   para   diferentes  lenguajes  de  programación.   •  Las   APIs   son   publicadas   como   webservices   REST   y   la   autenWcación  de  los  usuarios  se  realiza  a  través  de  OAUTH.  
  5. 5. Bluevia  y  Java   liminal-­‐it.com  Bluevia   •  El   acceso   a   los   recursos   de   la   red   es   autorizado   por   los   usuarios  mediante  OAUTH.   •  Con   OAUTH,   los   datos   idenWdad   (login,   password)   de   los   usuarios   permanecen   privados   y   no   son   comparWdos   con   las   aplicaciones  Bluevia.  
  6. 6. Bluevia  y  Java   liminal-­‐it.com  Modelo  de  desarrollo   Mi  aplicación   internet  
  7. 7. Bluevia  y  Java   liminal-­‐it.com  Modelo  de  desarrollo   Mi  aplicación   internet  
  8. 8. Bluevia  y  Java   liminal-­‐it.com  Modelo  de  desarrollo  En  el  caso  de  otros  lenguajes,  la  invocación  de  las  APIs  se  hace  mediante  consumo  de  los  web  services  REST.       Mi  aplicación   internet  
  9. 9. Bluevia  y  Java   liminal-­‐it.com  Modelo  de  desarrollo  
  10. 10. Bluevia  y  Java   liminal-­‐it.com  Desarrolladores  Bluevia  El  modelo  de  desarrollo,  incluye      1.  Registro  en  Bluevia:  h]ps://bluevia.com/en/user/register.  2.  Obtener  API  Keys  Un   API   key   es   requerida   por   cada   aplicación,   con   el   fin   de   usar   las   APIS  bluevia.  De  acuerdo  con  el  Wpo  de  Key  (Test  o  Comercial)  las  APIs  se  pueden  uWlzar  en  modo  SANDBOX  o  LIVE.             SANDBOX:   ambiente   para   LIVE:   ambiente   que   usa   la   pruebas   que   no   genera   red   de   tefónica   de   forma   tráfico  en  la  red.   real.      
  11. 11. Bluevia  y  Java   liminal-­‐it.com  Desarrolladores  Bluevia  
  12. 12. Bluevia  y  Java   liminal-­‐it.com  Desarrolladores  Bluevia  
  13. 13. Bluevia  y  Java   liminal-­‐it.com  Escenarios  de  desarrollo   Test  API  Key   Commercial  API  Key   Sandbox   Fase  inicial  de  desarrollo   Pruebas  antes  de  iniciar  el  proceso  de   -­‐  Pruebas  de  la  aplicación   acreditación  de  la  aplicación  o  antes   -­‐  Simulación  de  error   de  subir  a  una  App  Store.   -­‐  No  genera  tráfico   Live   Pruebas  con  desarrolladores   -­‐    Transacciones  sobre  la  red  de   registrados  y  que  tengan  crédito   acuerdo  con  el  modelo  comercial   para  uso  de  las  APIS.   seleccionado.    
  14. 14. Bluevia  y  Java   liminal-­‐it.com     REST  
  15. 15. Bluevia  y  Java   liminal-­‐it.com  Métodos  protocolo  HTTP   Método  (Verbo)   Uso   OPTIONS   Retorna  los  métodos  soportados  por  el  servidor   GET     Solicita  una  representación  de  un  recurso   HEAD     Igual  que  GET  pero  sin  cuerpo   POST     Envía  datos  para  ser  procesados     PUT     Envía  una  representación  de  un  recurso   DELETE     Elimina  el  recurso   TRACE     Solicita  retorno  del  mensaje  enviado   CONNECT   Convierte  el  request  a  un  tunel  TCP/IP  
  16. 16. Bluevia  y  Java   liminal-­‐it.com  Códigos  de  estado  HTTP   Código   Descripción   1xx   Información   2xx   Éxito   3xx   Redirección   4xx   Error  del  cliente   5xx   Error  del  servidor  
  17. 17. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",        oauth_consumer_key="Gjqq11099SE",        oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  18. 18. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   Método   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",     HTTP      oauth_consumer_key="Gjqq11099SE",          oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  19. 19. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   Request   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",     URI      oauth_consumer_key="Gjqq11099SE",          oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  20. 20. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",     Versión      oauth_consumer_key="Gjqq11099SE",     HTTP      oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",          oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  21. 21. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   AuthorizaSon:  OAuth        realm="hVps://api.bluevia.com",        oauth_consumer_key="Gjqq11099SE",        oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",     Headers      oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",          oauth_Smestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaSon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  22. 22. Bluevia  y  Java   liminal-­‐it.com  Mensaje  HTTP  -­‐  Request   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",        oauth_consumer_key="Gjqq11099SE",        oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>   Cuerpo  del      <tns:originAddress>   mensaje          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>        </tns:originAddress>   </tns:smsText>  
  23. 23. Bluevia  y  Java   liminal-­‐it.com   Mensaje  HTTP  –  Request/Response   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   AuthorizaWon:  OAuth        realm="h]ps://api.bluevia.com",        oauth_consumer_key="Gjqq11099SE",        oauth_token="4bf499a1ecaac050dfaddfef87f99e3a",        oauth_signature_method="HMAC-­‐SHA1",        oauth_signature="8I4319SRY0zLjv15RwqpuF7%2BOso%3D",        oauth_Wmestamp="1291898799",        oauth_nonce="15339077371968105486410263075"   Content-­‐Type:  applicaWon/xml   Host:  api.bluevia.com:443     <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  >      <tns:address>          <tns1:phoneNumber>524794786537</tns1:phoneNumber>      </tns:address>   internet      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias>      </tns:originAddress>   </tns:smsText>  HTTP/1.1  201  Created  LocaWon:  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022134544108250/deliverystatus  Content-­‐Length:  0  
  24. 24. Bluevia  y  Java   liminal-­‐it.com  REST   •  REpresentaWonal  State  Transfer.   •  EsWlo  arquitectónico  para  aplicaciones  distribuidas.   •  El   uso   de   un   conjunto   limitado   de   operaciones,   con   una   semánWca   uniforme,   es   suficiente   para   construir   cualquier   Wpo  de  aplicación.   •  Los   estados   de   un   proceso   pueden   ser   modelados   como   recursos.   •  Información   semánWca   sobre   los   pasos   del   proceso   de   negocio,  están  embebidos  en  las  URIs.  
  25. 25. Bluevia  y  Java   liminal-­‐it.com  CRUD  Web  services   Bajo   el   esWlo   REST,   las   operaciones   CRUD   son   suficientes   para   construir  cualquier  Wpo  de  aplicación.   Método  HTTP   URI   Uso   POST   /message   Crear/enviar   GET   /message/{id}   Consultar  estado   PUT   /message/{id}   Actualizar     DELETE   /message/{id}   Eliminar  
  26. 26. Bluevia  y  Java   liminal-­‐it.com  CRUD  Web  services  -­‐  POST   Cliente   POST  /services/message  HTTP/1.1   Servidor   ….   Host:  test.com     El  mensaje   h]p://test.com/services/message   201  Created   Exito   LocaSon  hVp://test.com/services/ message/12345   400  Bad  request   Error   500  Internal  error  
  27. 27. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  hVps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia    
  28. 28. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia.   •  IdenSficador  del  API.    
  29. 29. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia.   •  IdenWficador  del  API.   •  Operación.    
  30. 30. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia.   •  IdenWficador  del  API.   •  Operación.   •  IdenSficador  del  recurso.    
  31. 31. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia.   •  IdenWficador  del  API.   •  Operación.   •  IdenWficador  del  recurso.   •  Parámetros.   Mas  info  en     h]ps://bluevia.com/en/knowledge/APIs.API-­‐Guides   h]ps://bluevia.com/en/knowledge/APIs.API-­‐Reference    
  32. 32. Bluevia  y  Java   liminal-­‐it.com  URLs  para  APIs  de  Bluevia  h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/10001022145853108719/deliverystatus?version=v1&alt=json   •  URI  de  acceso  a  Bluevia.   •  IdenWficador  del  API.   •  Operación.   •  IdenWficador  del  recurso.   •  Parámetros.   Mas  info  en     h]ps://bluevia.com/en/knowledge/APIs.API-­‐Guides   h]ps://bluevia.com/en/knowledge/APIs.API-­‐Reference    
  33. 33. Bluevia  y  Java   liminal-­‐it.com  APIs  -­‐  Formatos  de  Mensaje   Los   mensajes   en   métodos   POST   y   PUT   pueden   enviarse   uWlizando  XML,  JSON  o  URL  encoded:   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   Content-­‐Type:  applicaWon/xml     Host:  api.bluevia.com:443     XML   <?xml  version="1.0"  encoding="UTF-­‐8"?>   <tns:smsText  xmlns:tns="h]p://www.telefonica.com/schemas/UNICA/REST/sms/v1/"     xmlns:tns1=h]p://www.telefonica.com/schemas/UNICA/REST/common/v1    xmlns:xsi="h]p://www.w3.org/2001/XMLSchema-­‐instance"     xsi:schemaLocaWon="h]p://www.telefonica.com/schemas/UNICA/REST/sms/v1/     UNICA_API_REST_sms_types_v1_0.xsd  ">      <tns:address>          <tns1:phoneNumber>52200009</tns1:phoneNumber>      </tns:address>      <tns:message>This  is  a  text  message</tns:message>      <tns:originAddress>          <tns1:alias>30c8db243ad31380e90f3fd650af9351</tns1:alias>      </tns:originAddress>   </tns:smsText>  
  34. 34. Bluevia  y  Java   liminal-­‐it.com  APIs  -­‐  Formatos  de  Mensaje   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   Content-­‐Type:  applicaWon/json   Host:  api.bluevia.com:443   JSON     {"smsText":  {      "address":  {"phoneNumber":  "52200009"},      "message":  "This  is  a  text  message",      "originAddress":  {"alias":  "30c8db243ad31380e90f3fd650af9351"},   }}   URL   POST  /services/REST/SMS/outbound/requests?version=v1  HTTP/1.1   Content-­‐Type:  applicaWon/x-­‐www-­‐form-­‐urlencoded   Host:  api.bluevia.com:443     address.phoneNumber=52200009&message=This+is+a+text +message&originAddress.alias=30c8db243ad31380e90f3fd650af9351  
  35. 35. Bluevia  y  Java   liminal-­‐it.com  APIs  –  Códigos  de  respuesta  y  error   Código   Descripción   200  OK   Éxito.  Respuesta  {pica  para  GET  y  DELETE   201  Created   Recurso  creado  exitosamente  (POST,  PUT)   202  Accepted   Solicitud  aceptada  para  procesamiento.   204  No  Content   Éxito,  pero  la  respuesta  no  requiere  contenido.   Código  error   Descripción   400   Mensaje  request  con  formato  inváido   401   AutenWcación  requerida   403   El  servicio  no  puede  cumplir  con  la  solicitud,   violación  de  acuerdos  de  nivel  de  servicio.   404   La  URI  no  es  válida   500   “Intermal  Error”  
  36. 36. Bluevia  y  Java   liminal-­‐it.com     OAUTH  
  37. 37. Bluevia  y  Java   liminal-­‐it.com  OAUTH  OAUTH   permite   comparWr   recursos   privados   (fotos,   listas   de  contactos,   números   de   cuentas,   etc)   alojados   en   siWos,   de   tal  forma  que  otras  aplicaciones  los  puedan  uWlizar  sin  almacenar  o  solicitar  las  credenciales  privadas.   La  aplicación  no  es  del   proveedor  de     mensajería   Ejemplo:   una   aplicación   para   mensajería   SMS/MMS   por   internet   requiere   una   autorización   para   poder   realizar   la   facturación   a   nombre  del  propietario  del  número  que  envía  el  mensaje.  
  38. 38. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Definiciones   •  Proveedor  del  servicio/Servidor:  siWo  o  web  services  donde  se   encuentran  los  recursos.   •  Usuario  :  el  propietario  de  los  recursos.   •  Consumidor/Cliente:   la   aplicación   que   quiere   acceder   a   los   recursos.   •  Token:   mecanismo   diferente   a   las   credenciales   del   usuario,   que  son  usados  para  acceder  a  los  recursos.  Puede  ser  de  Wpo   Request  o  Access.    
  39. 39. Bluevia  y  Java   liminal-­‐it.com  OAUTH     El  propietario   El  servidor  y     los  recursos   1.  Request  token   La  aplicación  cliente  
  40. 40. Bluevia  y  Java   liminal-­‐it.com  OAUTH     El  propietario   El  servidor  y     los  recursos   2.  Solicita     autorización   1.  Request  token   La  aplicación  cliente  
  41. 41. Bluevia  y  Java   liminal-­‐it.com  OAUTH     3.  Se  autenWca  y  da  autorización   para  el  acceso   El  propietario   El  servidor  y     los  recursos   2.  Solicita     autorización   1.  Request  token   La  aplicación  cliente  
  42. 42. Bluevia  y  Java   liminal-­‐it.com  OAUTH     El  propietario   El  servidor  y     los  recursos   4.  Access  token   5.  Acceso  a  los  recursos   La  aplicación  cliente  
  43. 43. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 Un  usuario  quiere  enviar  un  SMS  (con  cargo  a  su  cuenta)    a  través  de  una  aplicación  web  
  44. 44. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 La  aplicación  solicita  “unathorized  request  token”   al  proveedor  del  servicio  
  45. 45. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     La  aplicación  redirecciona  el  flujo  a     la  página  del  servicio  de  autorización   h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 h]p://autorizando.com   Login   Passwd  
  46. 46. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 El  usuario  da  la  autorización   h]p://autorizando.com   h]p://autorizando.com   Login   Autoriza  a     Passwd   enviesms.com  para   Enviar  SMSs  ?  
  47. 47. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje             La  aplicación  obWene   “authorized  request  token”       h]p://autorizando.com   h]p://autorizando.com   Login   Autoriza  a     Passwd   enviesms.com  para   Enviar  SMSs  ?  
  48. 48. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 La  aplicación  solicita  un  “access  token”  con   el  “authorized  request  token”  
  49. 49. Bluevia  y  Java   liminal-­‐it.com  OAUTH  -­‐  Ejemplo     h]p://Enviesms.com   Su  número     Enviar  a   Mensaje                 Con  el  access  token,  la  aplicación  solicita  al  servidor   del  proveedor  de  mensajería,  el  envío  del  mensaje  
  50. 50. Bluevia  y  Java   liminal-­‐it.com     SDK  PARA  JAVA  
  51. 51. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  
  52. 52. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java   Paquete   Descripción   com.bluevia.examples   Ejemplos  de  invocación  de  las  APIs   com.bluevia.java.directory   Clases  para  invocar  API  –  user  context     com.bluevia.java.gap   Clases  para  invocar  API  -­‐adverWsement     com.bluevia.java.locaWon   Clases  para  invocar  API  -­‐  locaWon     com.bluevia.java.mms   Clases  para  invocar  API  -­‐  MMS     com.bluevia.java.oauth   Clases  para  invocar  API  de  autenWcación   com.bluevia.java.sms   Clases  para  invocar  API  -­‐  SMS   com.telefonica.schemas.unica.rest. Clases  generadas  por  Java  XML  binding   *   (JAXB),  para  los  esquemas  de  los  Wpos.  
  53. 53. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  -­‐  Funcionalidades   OAUTH   •  Solicitar  RequestToken  y  AccessToken.     ADVERTISEMENT   •  Consultar  un  Ad  (un  Ad  se  compone  de  un  elemento  creaWvo   y    una  interacción).    
  54. 54. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  –  Ejemplo  OAUTH  
  55. 55. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  -­‐  Funcionalidades   SMS/MMS   •  Envío  de  SMS/MMS  a  múlWples  desWnos.   •  Verificar  estado  del  envío  de  SMS/MMS:   –   La  aplicación  solicita  el  envío  de  noWficaciones  sobre  el  estado.   –  La  aplicación  explícitamente  consulta  el  estado.   Posibles  estados:  DeliveredToNetwork,  DeliveryUncertain,  DeliveryImpossible,     MessageWaiWng,  DeliverdToTerminal,    DeliveryNoWficaWonUnsupported.   •  Recepción  de  SMS/MMS  por  demanda  o  a  través  de  noWficaciones.   •  Recepción  de  adjuntos  en  MMS.  
  56. 56. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  –  Ejemplo  SMS  
  57. 57. Bluevia  y  Java   liminal-­‐it.com  SDK  para  Java  -­‐  Funcionalidades   DIRECTORY/USER  CONTEXT   •  Consultar  información  personal  del  usuario.   •  Consultar  perfil  del  usuario.   •  Consultar  información  de  la  red.   •  Consultar  información  del  equipo.   LOCATION   •  Consultar  información  de  localización  del  equipo.  
  58. 58. Bluevia  y  Java   liminal-­‐it.com     DOCUMENTACIÓN  
  59. 59. Bluevia  y  Java   liminal-­‐it.com  Documentación  •  Guía  de  inicio              h]ps://bluevia.com/en/knowledge/getStarted  •  Guía  del  desarrollador    APIs            h]ps://bluevia.com/en/knowledge/APIs.API-­‐Guides    •  Manual  de  referencia  APIs            h]ps://bluevia.com/en/knowledge/APIs.API-­‐Reference    •  Documentación  propia  de  cada  SDK  
  60. 60. Bluevia  y  Java   liminal-­‐it.com     Mario  Linares  Vásquez   mario.linares@liminal-­‐it.con     GRACIAS  

×