BASE URL: https://api.javiercarrasco.es/coffee/
Indica que la petición requiere autenticación mediante token.
https://api.javiercarrasco.es/coffee/coffee/{id}
Authorization Bearer Token
Devuelve el tipo de café indicado a través de su identificador.
200 OK
{
"id": 4,
"coffee_name": "Americano",
"coffee_desc": "El café americano es un derivado del espresso, al cual se le añade una cantidad de agua mucho mayor de lo habitual en la preparación, obteniendo un producto con un sabor menos potente y más aguado, siendo menos amargo. En primer lugar se elaboraría un espresso y posteriormente se añade agua hirviendo."
}
401 Unauthorized
{
"ok": false,
"message": "Token inválido"
}
403 Forbidden
{
"ok": false,
"message": "No se proporcionó un token válido"
}
https://api.javiercarrasco.es/coffee/comments/{idCoffee}
Authorization Bearer Token
Obtiene la lista de comentarios de los usuarios según el identificador del tipo de café indicado.
200 OK
[
{
"id": 1,
"idCoffee": 1,
"user": "javier",
"comment": "Últimamente me estoy aficionando a este tipo de café."
},
{
"id": 3,
"idCoffee": 1,
"user": "rosa",
"comment": "Este tipo de café debe tomarse sin azúcar."
},
{
"id": 4,
"idCoffee": 1,
"user": "pepe",
"comment": "No me gusta especialmente."
},
...
]
401 Unauthorized
{
"ok": false,
"message": "Token inválido"
}
403 Forbidden
{
"ok": false,
"message": "No se proporcionó un token válido"
}
https://api.javiercarrasco.es/coffee/coffee
Authorization Bearer Token
Devuelve el listado de los diferentes tipos de cafés existentes en la API.
200 OK
[
{
"id": 1,
"coffee_name": "Espresso",
"comments": "7"
},
{
"id": 2,
"coffee_name": "Ristretto",
"comments": "0"
},
...
]
401 Unauthorized or 403 Forbidden
{
"ok": false,
"message": "Token inválido"
}
https://api.javiercarrasco.es/coffee/login
Autentica al usuario mediante su usuario y contraseña, devolviendo un token válido. La petición deberá pasar los datos en el cuerpo.
Body raw (json)
{"usuario": "pedro", "password": "asdfasd"}
200 OK
{
"ok": true,
"token": "eyJhbGciOiJIUzI1NiIasdfasdfaVyIiwia...yOasdfasdfgXp6M24mZWV2-afs3va"
}
400 Bad Request
{
"ok": false,
"message": "Todos los campos son obligatorios"
}
401 Unauthorized
{
"ok": false,
"message": "Credenciales incorrectas"
}
https://api.javiercarrasco.es/coffee/comments
Authorization Bearer Token
Permite registrar un comentario de usuario para un café en la API. Deberá pasarse los datos en el cuerpo de la petición, indicando el identificador del café sobre el que se hace el comentario y el texto del comentario.
Body raw (json)
{"idCoffee": 3, "comment": "Comentario de prueba."}
201 Created
{
"id": 25,
"idCoffee": 3,
"user": "pepe",
"comment": "Comentario de prueba."
}
400 Bad Request
{
"ok": false,
"message": "Datos inválidos. Verifica que idCoffee sea un identificador válido y comment no esté vacío."
}
400 Bad Request
{
"ok": false,
"message": "No se pudo insertar el comentario en la base de datos. Inténtalo de nuevo más tarde."
}
401 Unauthorized
{
"ok": false,
"message": "Usuario del token no existe, por favor, inicia sesión de nuevo."
}
401 Unauthorized
{
"ok": false,
"message": "Token inválido"
}
403 Forbidden
{
"ok": false,
"message": "No se proporcionó un token válido"
}