1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
1)Hola y bienvenidos a este tutorial para aprender a como manejar la plataforma de Taler, así como el acceso a su API.
2) Para poder seguir este videotutorial necesitarás tener acceso a un backend de vendedor (merchant) de GNU Taler, del estilo backend.demo.taler.net, pero sino cuentas con un servidor personal puedes usar el entorno demo de taler.net,
que tiene la direccion https://backend.demo.taler.net.
Para este tutorial no lo necesitarás quizás, pero para el resto de tutoriales, necesitarás tener instalada una Taler Wallet (extension de navegador o APP en tu teléfono móvil).
Sino cuentas con una cartera Taler (wallet), existe otro tutorial disponible que te ayudará a conocer como instalar una,
bien en tu teléfono móvil (debe de ser un smartphone), o en tu navegador (como una extensión).
Para realizar este demostración de como acceder a los programas de la API, vamos a usar un software llamado "insomnia",
que nos permite visualizar las peticiones que realizamos contra la API, pero realmente puedes usar cualquier otro Software para el manejo de APIs,
o incluso implementar directamente los códigos API en tu lenguaje de programación preferido, como por ejemplo Python.
Para poder seguir este videotutorial en las mejores condiciones aconsejamos enormemente que uses el servidor de backend para demostraciones: backend.demo.taler.net.
3) El servidor de merchant backende demo, está disponible en la dirección https://backend.demo.taler.net, con la contraseña "sandbox".
De todas formas si deseas desplegar tu propia plataforma de backend, existe otro video-tutorial específicamente para realizar eso.
4) Primero que nada, empieza abriendo tu navegador y comprobando el puerto accede a la pagina de vendedor "merchant", conecta con tu RFC 8959 compliant access token, que como recordatorio es "sandbox" para el backend de demostración.
Cuando veas la pagina principal, verás lo primero los pedidos que están a la espera de procesamiento.
Los pedidos están ocultos en el backend (ya que no son nuevos), pincha en "All" para verlos todos.
Encontrarás con seguridad muchos pedidos que están en proceso, que bien han sido cancelados, pagados o reembolsados.
Realmente es un histórico de todos los pedidos. Si estás haciendo uso de tu propio servidor con tu propia instalación del merchant backend de Taler,
seguramente no veas ningún pedido, pero no te preocupes, porque puedes continuar viendo el video-tutorial.
5) Verás que todas las transacciones del servidor están realizadas en la divisa ficticia "KUDOS", y esta se utiliza exclusivamente de forma ficiticia en el servidor demo de Taler para realizar la demostración.
La divisa ficticia KUDOS, se encuentra tanto en la wallet, como en el backend del merchant.
Ten en cuenta los servidores de demostración no aceptan ningún otro tipo de divisa, más que kudos.
6) Ahora que ya tienes acceso a tu interfaz o backend de vendedor, a través de tu navegador, vamos a comprobar que la API del servidor está funcionando igualmente,
para esto bien abre tu programa de manejo de API y apertura una plantilla que te permita ver las peticiones a la API.
Prepara la primera llamada a la API (nosotros vamos a usar el programa Insomnia), y vamos a indicar la dirección del merchant igual a la de la demostración de taler que es https://backend.demo.taler.net.
La meta de esta ruta, es listar todos los pedidos que han sido procesados por el servidor de backend de vendedor,
y si hay algun tipo de error, nos devolverá una lista vacía.
Vamos a llevar a cabo una petición GET al endpoint de nuestro backend, /private/orders, pero antes de poder enviar esta petición concreta, necesitaremos incluir la información de autenticación como encabezado.
Tienes que especificar un tipo de autenticacion, en este caso "Bearer Token", que debemos rellenar con la cadena "secret-token:sandbox", para el caso del servidor demo.
Tendrás que enviar este mismo encabezado cada vez, para cada nueva cada petición, que quieras mandar la API con la ruta /private/*, y no lo olvides es un "Bearer Token".
Si estáss usando un programa de manejo de peticiones API, quizás ahora es el mejor momento para guardarlo, y así poder realizar futuras peticiones al servidor.
Ahora ya puedes enviar esta petición a la API, bien sea el servidor merchant demo de Taler, o tu propio servidor merchant y si usas la clave de acceso correcta,
podrás ver todas la lista de transacciones que se han realizado en el servidor merchant.
Sino tuvieras ninguna transacción en tu servidor merchant, puedes al menos comprobar que el código de respuesta es 200,y que no empieza por 4 o 5, ya que esto seria sintomático de un error.
Una de las ventaja de usar "Insomnia", es que puedes re-utilizar tu espacio de trabajo y transformarlo hacia código fuente del lenguaje de programación de tu elección.
Para ello, pincha en la flecha que apunta hacia abajo del botónn enviar, y pulsa sobre la opción "Generate client code", y así vas a ser capaz de generar código para cualquier lenguaje de programción como C, C sharp, Java, o Kotlin. En nuestro caso vamos a usar el lenguaje de programación Python.
El código generado es el código equivalente a la petición que hemos creado con el programa Insominia, junto con toda la información de esta petición contenida dentro de este código.
6), Así que simplemente copia y pega el código generado, del lenguaje de programacion que hayas elegido,
en nuestro caso vamos a crear un archivo de texto plano para python. Copiamos el código generado dentro, guardamos el archivo, y luego simplemente lo ejecutamos.
Cuando lo ejecutemos podremos ver que todos los pedidos que veíamos en el programa "Insomnia", ahora los podemos ver por pantalla en modo texto.
Felicidades, has conseguido acceder a la API del servidor de vendedor (merchant) de Taler.
Ahora ya podemos pasar al siguiente tutorial, para aprender a crear nuevas transacciones, comprobar los pagos, y manejar todas las plantillas re-usables.
Muchas gracias por seguir este primer tutorial de inciación, nos vemos muy pronto para aprender de manera mas profunda el manejo de la API de Taler.
|
