Utilizar el Web Service
- Una URL (o "endpoint") solicitada
- un método
- encabezados (o "headers")
- datos (o "body")
El punto de entrada (endpoint)
El punto de entrada ( root-endpoint) de API es: https://secure.lyra.com/sdd.
Se ponen a disposición varios recursos asociados cada uno a un camino (path) diferente:
Acción | Método | URl |
---|---|---|
Importar un mandato existente | POST | /mandates |
Importar varios mandatos existentes | POST | /multimandates |
Consultar los datos de un mandato | GET | /mandates/:id |
Descargar un mandato | GET | /mandates/:id |
Actualizar un mandato | PUT | /mandates/:id |
Eliminar un mandato | DELETE | /mandates/:id |
( :) en el camino indica una variable. Debe reemplazar esta variable por un valor real cuando envía su solicitud. En nuestro caso, debe reemplazar :id por la ID del mandato que usted desea utilizar.
El método
Cada recurso es accesible a través de un método específico. Este método traduce la acción que usted desea realizar (ver tabla a continuación).
- GET Esta solicitud se utiliza para obtener un recurso desde el servidor.
- POST Esta solicitud se utiliza para crear un nuevo recurso.
- PUT Esta solicitud se utiliza para actualizar un nuevo recurso.
- DELETE Esta solicitud se utiliza para eliminar un recurso.
Los encabezados
Los encabezados HTTP son pares de clave-valores separados por ":".
Se utilizan para transmitir los datos de autenticación y de las informaciones sobre el contenido de la solicitud.
Los encabezados utilizados en esta API se describen en el capítulo Identificarse durante los intercambios.
Los datos (o "body")
Los datos (también llamados "body" o "mensaje") contienen las informaciones que usted desea transmitir al servidor. Solo se utilizan en las solicitudes POST y PUT.
En las solicitudes y respuestas, los datos se transmiten en formato JSON (Javascript Object Notation). En este formato, cada propiedad y valor se enmarcan por dobles cuotas:
{ "propiedad1": "valor1", "propiedad2": "valor2" }
Probar el web service con cURL
Esta parte supone que usted ya ha instalado cURL.
Para utilizar cURL, escribir curl seguido del endpoint que desea interrogar.
Ejemplo recurriendo a nuestro root-endpoint:
curl https://secure.lyra.com/sdd
Al realizar la validación, usted obtiene la siguiente respuesta:
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN"> <html><head> <title>404 Not Found</title> </head><body> <h1>Not Found</h1> <p>The requested URL /sdd was not found on this server.</p> <p>Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.</p> </body></html>
Para obtener la lista de los mandatos registrados en su tienda, modificar la línea de pedido precedente especificando el endpoint "/mandates” :
curl https://secure.lyra.com/sdd/mandates
Usted obtendrá la siguiente respuesta:
{ "name" : "ERROR", "message" : "Service error", "details" : "RESTEASY001545: No resource method found for GET, return 405 with Allow header" }
Obtiene esta respuesta ya que no se ha autentificado.
Ahora descubramos cómo autentificarse utilizando los encabezados HTTP.