Si usted quiere desarrollar con Bluevia y Java, esto es lo primero que debe saber

Transcripción

1

2

3 LIMINAL Si usted quiere desarrollar con Bluevia y Java, esto es lo primero que debe saber Mario Linares Vásquez mario.linares@liminal-it.con Junio 30 de 2011

4 Network as a Service - NaaS Que información poseen los operadores de móviles? Llamadas. Mensajes. Ubicación de los equipos. Perfil de los usuarios y los equipos. Facturación. NaaS: información y servicios de la red (network intelligence) son ofrecidos a los usuarios y a terceros. Network as a Service - NaaS

5 Telco 2.0 business model Usuarios Application Service Providers APIs Telco Network as a Service - NaaS

6 Modelo de desarrollo REST OAUTH SDK para Java Documentación AGENDA

7 MODELO de desarrollo

8 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. APIs y SDKs Diferentes lenguajes de programación. webservices autorización REST OAUTH

9 OAUTH El acceso a los recursos de la red es autorizado por los usuarios mediante OAUTH. Con OAUTH, los datos identidad (login, password) de los usuarios permanecen privados y no son compartidos con las aplicaciones BlueVia.

10 App SDK BlueVia Internet MMS Send API MMS Receive API SMS Receive API SMS Send API Location API User Context API Advertising API

11 App SDK BlueVia Internet MMS Send API MMS Receive API SMS Receive API SMS Send API Location API User Context API Advertising API REST

12 App BlueVia Internet MMS Send API SMS Receive API MMS Receive API SMS Send API Location API User Context API Advertising API

13 SMS Send API SMS Receive API MMS Receive API MMS Send API Advertising API User Context API Location API

14 Desarrolladores El modelo de desarrollo, incluye 1. Registro en Bluevia: 2. Obtener API Keys

15 Desarrolladores Un API key es requerida por cada aplicación, con el fin de usar las APIS Bluevia. De acuerdo con el tipo de Key (Test o Comercial) las APIs se pueden utilizar en modo SANDBOX: Ambiente para pruebas que no genera tráfico en la red. LIVE: ambiente que usa la red de telefónica de forma real.

16 Desarrolladores Bluevia

17 Desarrolladores Bluevia

18 Escenarios de desarrollo Test API Key Commercial API Key Sandbox Fase inicial de desarrollo Pruebas de la aplicación Simulación de error No genera tráfico Pruebas antes de iniciar el proceso de acreditación de la aplicación o antes de subir a una App Store. Live Pruebas con desarrolladores registrados y que tengan crédito para uso de las APIS. Transacciones sobre la red de acuerdo con el modelo comercial seleccionado.

19 REST representational state transfer.

20 Métodos protocolo HTTP Método (Verbo) OPTIONS GET HEAD POST PUT DELETE TRACE CONNECT Uso Retorna los métodos soportados por el servidor Solicita una representación de un recurso Igual que GET pero sin cuerpo Envía datos para ser procesados Envía una representación de un recurso Elimina el recurso Solicita retorno del mensaje enviado Convierte el request a un tunel TCP/IP

21 Códigos de estado HTTP Código Descripción 1xx 2xx 3xx 4xx 5xx Información Éxito Redirección Error del cliente Error del servidor

22 Mensaje HTTP - Request POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

23 Mensaje HTTP - Request Método HTTP POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

24 Mensaje HTTP - Request Request URI POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

25 Mensaje HTTP - Request Versión HTTP POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

26 Mensaje HTTP - Request Headers POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

27 Mensaje HTTP - Request POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 Cuerpo del mensaje <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext>

28 Mensaje HTTP Request/Response POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Authorization: OAuth realm=" oauth_consumer_key="gjqq11099se", oauth_token="4bf499a1ecaac050dfaddfef87f99e3a", oauth_signature_method="hmac-sha1", oauth_signature="8i4319sry0zljv15rwqpuf7%2boso%3d", oauth_timestamp=" ", oauth_nonce=" " Content-Type: application/xml Host: api.bluevia.com:443 Internet <?xml version="1.0" encoding="utf-8"?> <tns:smstext > <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>4bf499a1ecaac050dfaddfef87f99e3a</tns1:alias> </tns:originaddress> </tns:smstext> SMS Send API HTTP/ Created Location: /deliverystatus Content-Length: 0

29 REST Representational State Transfer. Estilo arquitectónico para aplicaciones distribuidas. El uso de un conjunto limitado de operaciones, con una semántica uniforme, es suficiente para construir cualquier tipo de aplicación.

30 REST Representational State Transfer. Los estados de un proceso pueden ser modelados como recursos. Información semántica sobre los pasos del proceso de negocio están embebidos en las URIs.

31 CRUD Web services Bajo el estilo REST, las operaciones CRUD son suficientes para construir cualquier tipo de aplicación. Método HTTP URI Uso GET /message Consultar estado POST /message/{id} Crear/enviar PUT /message/{id} Actualizar DELETE /message/{id} Eliminar

32 CRUD Web services - POST Cliente Servidor POST /services/message HTTP/1.1. Host: test.com El mensaje 201 Created Location Exito 400 Bad request Error 500 Internal error

33 URLs para APIs de Bluevia h"ps://api.bluevia.com/services/rest/sms/outbound/requests/ /deliverystatus?version=v1&alt=json URI de acceso a Bluevia

34 URLs para APIs de Bluevia hdps://api.bluevia.com/services/rest/sms/outbound/requests/ /deliverystatus?version=v1&alt=json URI de acceso a Bluevia. Identificador del API.

35 URLs para APIs de Bluevia hdps://api.bluevia.com/services/rest/sms/outbound/ requests/ /deliverystatus? version=v1&alt=json URI de acceso a Bluevia. Identificador del API. Operación.

36 URLs para APIs de Bluevia hdps://api.bluevia.com/services/rest/sms/outbound/requests/ /deliverystatus?version=v1&alt=json URI de acceso a Bluevia. Identificador del API. Operación. Identificador del recurso.

37 URLs para APIs de Bluevia hdps://api.bluevia.com/services/rest/sms/outbound/ requests/ /deliverystatus? version=v1&alt=json URI de acceso a Bluevia. Identificador del API. Operación. Identificador del recurso. Parámetros. Mas info en

38 URLs para APIs de Bluevia hdps://api.bluevia.com/services/rest/sms/outbound/requests/ /deliverystatus?version=v1&alt=json URI de acceso a Bluevia. Identificador del API. Operación. Identificador del recurso. Parámetros. Mas info en

39 APIs - Formatos de Mensaje Los mensajes en métodos POST y PUT pueden enviarse utilizando XML, JSON o URL encoded: POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Content-Type: application/xml Host: api.bluevia.com:443 XML <?xml version="1.0" encoding="utf-8"?> <tns:smstext xmlns:tns=" xmlns:tns1= xmlns:xsi=" xsi:schemalocation=" UNICA_API_REST_sms_types_v1_0.xsd "> <tns:address> <tns1:phonenumber> </tns1:phonenumber> </tns:address> <tns:message>this is a text message</tns:message> <tns:originaddress> <tns1:alias>30c8db243ad31380e90f3fd650af9351</tns1:alias> </tns:originaddress> </tns:smstext>

40 APIs - Formatos de Mensaje POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Content- Type: applicaqon/json Host: api.bluevia.com:443 {"smstext": { "address": {"phonenumber": " "}, "message": "This is a text message", "originaddress": {"alias": "30c8db243ad31380e90f3fd650af9351"}, }} JSON URL POST /services/rest/sms/outbound/requests?version=v1 HTTP/1.1 Content- Type: applicaqon/x- www- form- urlencoded Host: api.bluevia.com:443 address.phonenumber= &message=this+is+a+text +message&originaddress.alias=30c8db243ad31380e90f3fd650af9351

41 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álido 401 AutenQcación requerida 403 El servicio no puede cumplir con la solicitud, violación de acuerdos de nivel de servicio. 404 El servicio no puede cumplir con la solicitud, violación de acuerdos de nivel de servicio.

42 OAUTH

43 OAUTH OAUTH permite compartir recursos privados (fotos, listas de contactos, números de cuentas, etc) alojados en sitios, de tal forma que otras aplicaciones los puedan utilizar sin almacenar o solicitar las credenciales privadas. 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. La aplicación no es del proveedor de mensajería

44 OAUTH - Definiciones Proveedor del servicio/servidor: sitio 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 tipo Request o Access.

45 OAUTH 1. Request token Aplicación Servidor 2. Solicita autorización 3. Se autentica y da autorización para el acceso Propietario

46 OAUTH 4. Access token 5. Acceso a los recursos

47 OAUTH - Ejemplo hdp://enviaunsms.com EnviaUnSMS.com Su número Enviar a Mensaje Ok Un usuario quiere enviar un SMS (con cargo a su cuenta) a través de una aplicación web

48 OAUTH - Ejemplo hdp:// EnviaUnSMS.com Su número Enviar a Mensaje Ok La aplicación solicita unathorized request token al proveedor del servicio

49 OAUTH - Ejemplo hdp:// EnviaUnSMS.com Su número Enviar a Mensaje Ok La aplicación redirecciona el flujo a la página del servicio de autorización hdp://autorizando.com BlueVia connect hdp://autorizando. Autorización Userna Passwor

50 OAUTH - Ejemplo EnviaUnSMS.com BlueVia connect Autorización hdp://autorizando.com Username Password El usuario da la autorización EnviaUnSMS.com BlueVia connect Autorización Autoriza a enviaunsms.com para Enviar SMSs?

51 OAUTH - Ejemplo hdp:// EnviaUnSMS.com Su número Enviar a Mensaje hdp://autorizando.com La aplicación obqene authorized request token EnviaUnSMS.com BlueVia connect Autorización Autoriza a enviaunsms.com para Enviar SMSs?

52 OAUTH - Ejemplo hdp:// EnviaUnSMS.com Su número Enviar a Mensaje La aplicación solicita un access token con el authorized request token

53 OAUTH - Ejemplo hdp:// EnviaUnSMS.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

54 SDK

55 SDK para Java

56 SDK para Java Paquete Descripción com.bluevia.examples com.bluevia.java.directory com.bluevia.java.gap com.bluevia.java.location com.bluevia.java.mms com.bluevia.java.oauth com.bluevia.java.sms com.telefonica.schemas.unica.rest.* Ejemplos de invocación de las APIs Clases para invocar API user context Clases para invocar API -advertisement Clases para invocar API - location Clases para invocar API - MMS Clases para invocar API de autenticación Clases para invocar API - SMS Clases generadas por Java XML binding (JAXB), para los esquemas de los tipos.

57 SDK para Java - Funcionalidades OAUTH Solicitar RequestToken y AccessToken. ADVERTISEMENT Consultar un Ad (un Ad se compone de un elemento creativo y una interacción).

58 SDK para Java Ejemplo OAUTH

59 SDK para Java - Funcionalidades SMS/MMS Envío de SMS/MMS a múlrples desrnos. Verificar estado del envío de SMS/MMS: La aplicación solicita el envío de norficaciones sobre el estado. La aplicación explícitamente consulta el estado. Posibles estados: DeliveredToNetwork, DeliveryUncertain, DeliveryImpossible, MessageWaiQng, DeliverdToTerminal, DeliveryNoQficaQonUnsupported. Recepción de SMS/MMS por demanda o a través de norficaciones. Recepción de adjuntos en MMS.

60 SDK para Java Ejemplo SMS

61 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.

62 DOCUMENTACIÓN

63 Documentación Guía de inicio Guía del desarrollador APIs Manual de referencia APIs Documentación propia de cada SDK

64 Mario Linares Vásquez GRACIAS

65 LIMINAL-IT.com