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.