Esta guía explica brevemente cómo empezar a utilizar la API REST en ConnectedCooking. Por favor, tenga en cuenta que esta guía sólo se refiere a nuestras soluciones Cloud REST API.
- En primer lugar, es necesario crear un Cliente API en nuestra Cuenta ConnectedCooking. Por lo tanto, navegamos en nuestra cuenta ConnectedCooking en la pestaña Administración.
- A continuación, haga clic en Integraciones. La pestaña API sólo es visible para los administradores de cuenta.
- A continuación, haz clic en "+ Añadir nuevo".
- En la siguiente imagen usted proporciona un "ALIAS", asigna un GRUPO y elige un tipo de API. Para las consultas de la API relativas al APPCC y a los datos de su cuenta de ConnectedCooking, necesita el tipo de API "Base API". Después de rellenar todas las columnas, haga clic en "Añadir API".
- En la siguiente pantalla recibirá sus credenciales de cliente API. Por favor, guárdalas en un lugar seguro y haz clic en cerrar.
- Después de crear tu cliente API, necesitas una herramienta para usarlo. Para ello puedes utilizar curl, Postman o cualquier otra herramienta que conozcas. En esta guía usamos Postman.
- Por favor, inicie Postman a través de la aplicación o en un navegador web. A continuación, cree una nueva colección en blanco con el símbolo + y haga clic en "Añadir una solicitud". También puede crear una nueva solicitud HTTP haciendo clic en "Nueva".
- Además, usted tiene que editar su nueva solicitud creada a una solicitud POST para recibir el token portador con la ayuda de sus credenciales de cliente API de ConnectedCooking.
- Por lo tanto, debe consultar la documentación de la APIAutenticación | Centro de ayuda de ConnectedCooking
- La documentación explica que tienes que crear un token de portador para autenticar tus solicitudes de API posteriores.
- Esto se consigue mediante una solicitud POST. La solicitud POST utiliza el endpoint:https://app.connectedcooking.com/api/auth/access
- Además, debe establecer el Content-Type "x-www-form-urlencoded" en la pestaña body de su solicitud. A continuación, el nombre de usuario, la contraseña y el ámbito de su Cliente API deben insertarse en las columnas disponibles.
- Al final, haga clic en "Enviar" y ahora debe recibir su "accessToken = BearerToken"
- Para utilizar su BearerToken recién creado necesita cualquier API para utilizarlo.
- Puede consultar fácilmente todas las solicitudes de API posibles en la documentación Endpoints:Puntos finales | Centro de ayuda de ConnectedCooking
- Por ejemplo, intente utilizar la lista de dispositivos Endpoint.
- Esta solicitud es muy simple, ya que sólo tiene que utilizar "https://app.connectedcooking.com" y añadir "/api/public/devices" a la misma y copiar/pegar su "accessToken" de su solicitud POST en la pestaña de autorización como en la imagen de abajo. Solo tienes que seleccionar "Bearer Token" en Auth Type, entonces aparecerá el campo Token.
- Al final también haga clic en "Enviar" y debería recibir una lista de todos sus dispositivos registrados en su cuenta de ConnectedCooking (Esta lista está vacía si no tiene dispositivos en su cuenta).
Este ejemplo puede aplicarse básicamente a todos los puntos finales.
¡Enhorabuena, ya puedes utilizar las API REST con ConnectedCooking!
Si necesita información adicional, consulte nuestra Documentación de la API para ConnectedCooking:Introducción | Centro de ayuda de ConnectedCooking
