Liminal Bluevia 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

Bluevia
y
Java

liminal-‐it.com

Agenda

•  Modelo
de
desarrollo

•  REST

•  OAUTH

•  SDK
para
Java

•  Documentación.

Bluevia
y
Java

liminal-‐it.com

MODELO
DE
DESARROLLO

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.

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.

Bluevia
y
Java

liminal-‐it.com

Modelo
de
desarrollo

Mi
aplicación

internet

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

Bluevia
y
Java

liminal-‐it.com

Modelo
de
desarrollo

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
ﬁn
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áﬁco
en
la
red.
real.

Bluevia
y
Java

liminal-‐it.com

Desarrolladores
Bluevia

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áﬁco

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.

Bluevia
y
Java

liminal-‐it.com

REST

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

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

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>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
-‐
Request

POST
HTTP/1.1

Método
AuthorizaWon:
OAuth


HTTP






oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>

<tns:message>This
is
a
text

<tns:originAddress>



</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
-‐
Request

POST
HTTP/1.1

Request
AuthorizaWon:
OAuth


URI






oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>

<tns:message>This
is
a
text

<tns:originAddress>



</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
-‐
Request

POST
HTTP/1.1

AuthorizaWon:
OAuth


Versión


HTTP





oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>

<tns:message>This
is
a
text

<tns:originAddress>



</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
-‐
Request

POST
HTTP/1.1

AuthorizaSon:
OAuth

realm="hVps://api.bluevia.com",



Headers



oauth_Smestamp="1291898799",

oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaSon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>

<tns:message>This
is
a
text

<tns:originAddress>



</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
-‐
Request

POST
HTTP/1.1

AuthorizaWon:
OAuth







oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>

<tns:message>This
is
a
text

Cuerpo
del

<tns:originAddress>
mensaje



</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

Mensaje
HTTP
–
Request/Response

POST
HTTP/1.1

AuthorizaWon:
OAuth







oauth_nonce="15339077371968105486410263075"

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

<?xml
version="1.0"

<tns:smsText
>

<tns:address>


</tns:address>
internet

<tns:message>This
is
a
text

<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

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
suﬁciente
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.

Bluevia
y
Java

liminal-‐it.com

CRUD
Web
services

Bajo
el
esWlo
REST,
las
operaciones
CRUD
son
suﬁcientes
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

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

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

Bluevia
y
Java

liminal-‐it.com

URLs
para
APIs
de
Bluevia

h]ps://api.bluevia.com/services/REST/SMS/outbound/requests/

•  URI
de
acceso
a
Bluevia.

•  IdenSﬁcador
del
API.

Bluevia
y
Java

liminal-‐it.com

URLs
para
APIs
de
Bluevia


•  URI
de
acceso
a
Bluevia.

•  IdenWﬁcador
del
API.

•  Operación.

Bluevia
y
Java

liminal-‐it.com

URLs
para
APIs
de
Bluevia


•  URI
de
acceso
a
Bluevia.

del
API.

•  Operación.

•  IdenSﬁcador
del
recurso.

Bluevia
y
Java

liminal-‐it.com

URLs
para
APIs
de
Bluevia


•  URI
de
acceso
a
Bluevia.

del
API.

•  Operación.

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

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
HTTP/1.1

Content-‐Type:
applicaWon/xml

Host:
api.bluevia.com:443

XML

<?xml
version="1.0"

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


</tns:address>

<tns:message>This
is
a
text

<tns:originAddress>

<tns1:alias>30c8db243ad31380e90f3fd650af9351</tns1:alias>


</tns:smsText>

Bluevia
y
Java

liminal-‐it.com

APIs
-‐
Formatos
de
Mensaje

POST
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
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

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”

Bluevia
y
Java

liminal-‐it.com

OAUTH

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.

Bluevia
y
Java

liminal-‐it.com

OAUTH
-‐
Deﬁniciones

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

Bluevia
y
Java

liminal-‐it.com

OAUTH

El
propietario

El
servidor
y

los
recursos

1.
Request
token

La
aplicación
cliente

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

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

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

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

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

Bluevia
y
Java

liminal-‐it.com

OAUTH
-‐
Ejemplo

La
aplicación
redirecciona
el
ﬂujo
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

Bluevia
y
Java

liminal-‐it.com

OAUTH
-‐
Ejemplo

h]p://Enviesms.com

Su
número

Enviar
a

Mensaje

El
usuario
da
la
autorización



Login

Autoriza
a

Passwd

enviesms.com
para

Enviar
SMSs
?

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”



Login

Autoriza
a

Passwd

enviesms.com
para

Enviar
SMSs
?

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”

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

Bluevia
y
Java

liminal-‐it.com

SDK
PARA
JAVA

Bluevia
y
Java

liminal-‐it.com

SDK
para
Java

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.

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

Bluevia
y
Java

liminal-‐it.com

SDK
para
Java
–
Ejemplo
OAUTH

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.

Bluevia
y
Java

liminal-‐it.com

SDK
para
Java
–
Ejemplo
SMS

Bluevia
y
Java

liminal-‐it.com

SDK
para
Java
-‐
Funcionalidades

DIRECTORY/USER
CONTEXT

•  Consultar
información
personal
del
usuario.

•  Consultar
perﬁl
del
usuario.

•  Consultar
información
de
la
red.

•  Consultar
información
del
equipo.

LOCATION

•  Consultar
información
de
localización
del
equipo.

Bluevia
y
Java

liminal-‐it.com

DOCUMENTACIÓN

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

Bluevia
y
Java

liminal-‐it.com

Mario
Linares
Vásquez

mario.linares@liminal-‐it.con

GRACIAS

Liminal Bluevia 1

Más contenido relacionado

Destacado (16)

Similar a Liminal Bluevia 1 (20)

Más de campus party (20)

Último (20)

Liminal Bluevia 1