API Motor de reservas Acceso/Registro

Introducción

Bienvenido a la API de perfiles de clientes del motor de reservas de Mybooking.

Este API tiene tiene la funcionalidad necesaria para registrar un nuevo cliente, realizar el login de cliente y para gestionar el proceso "He olvidado mi contraseña".

Está diseñada de forma que se pueda utilizar tanto desde el navegador con JAMStack (opens new window) como desde su lenguaje preferido en el lado del servidor.

URL Base

https://micuenta.mybooking.es

Registro de usuario

POST Registro de Usuario

POST /api/v1/signup/customer

Registra un usuario

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional

Parámetros

Se envía el cuerpo en JSON con los siguientes atributos.

Parámetro	Descripción	Detalle
username	Identificador del usuario	Texto sin espacios	Obligatorio
password	Contraseña		Obligatorio
email	Correo electrónico		Obligatorio
name	Nombre del usuario		Obligatorio
surname	Apellidos del usuario		Obligatorio

[
  {
    "username": "myuser",
    "password": "mypassword",
    "email": "name@mycompany.com",
    "name": "John",
    "surname": "Doe"
  }
]

Resultado

Success

TIP

200

Retorna un Boolean, con el valor true si ha ido correctamente o false en caso contrario.

true

Acceso usuarios

POST Iniciar sesión

POST /api/v1/login

Inicio de sesión

Query String

Parámetro	Descripción	Detalle
username	Identificador del usuario o correo electrónico		Obligatorio
password	Contraseña		Obligatorio
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional

Resultado

Success

TIP

200

Retorna un objeto con el resultado de la identificación del usuario y su nombre completo en el caso que la identificación haya tenido éxito.

Además retorna un token JWT en la cabecera cabecera HTTP Authorization para poderlo usarlo en aquellas peticiones que requieran autenticación de un usuario cliente.

Parámetro		Descripción	Detalle
connected		Indica si la identificación es correcta	Boolean
user			object[object]
	full_name	Nombre completo del usuario	String

[
  {
    "connected": true,
    "user": {
      "full_name": "John Doe"
    }
  }
]

DELETE Cerrar sesión

DELETE /api/v1/logout

Finalizar sesión

Resultado

Success

TIP

200

Restablecer contraseña

POST Comprobar usuario

POST /api/v1/web-customer/check-user-email

Comprueba si el usuario o correo electrónico están registrados en el sistema

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional

Body parameters

Parámetro	Descripción	Detalle
username	Identificador del usuario o correo electrónico		Obligatorio

{
  "username": "myusername"
}

Resultado

Success

TIP

200

POST He olvidado contraseña

POST /api/v1/web-customer/password-forgotten

Solicita que se envíe un correo electrónico con un enlace para poder restablecer la contraseña del usuario

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional

Body parameters

Parámetro	Descripción	Detalle
username	Identificador del usuario o correo electrónico		Obligatorio

{
  "username": "myusername"
}

Resultado

Success

TIP

200

POST Cambiar contraseña

POST /api/v1/web-customer/change-password

Cambia la contraseña del usuario

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional

Body parameters

Parámetro	Descripción	Detalle
password	Nueva contraseña		Obligatorio
password_forgotten_hash	Hash contraseña olvidada		Obligatorio

{
  "password": "mypassword",
  "password_forgotten_hash": "3183jklhadlh3701371092812"
}

Resultado

Success

TIP

200