Autenticación

Para autenticarte al realizar solicitudes API a la API de Rappi, necesitas un Token de acceso.

El API de Rappi utiliza un esquema de Bearer authentication, como método de autenticación HTTP para solicitudes de API.

Para realizar solicitudes a la API, envía el token en un encabezado customizado para interactuar con los recursos protegidos.

Rappi utiliza el siguiente esquema para la autenticación Bearer:

KeyValue
x-authorizationBearer: <access_token>

La siguiente tabla describe los diferentes contenidos del recurso de autenticación:

RecursosDescripcionObservaciones
POST v1/token/login/integrationsUtilice este punto final para generar un token de acceso para los servicios de integraciones
POST v1/token/login/utilsUtilice este punto final para generar un token de acceso para los servicios de utils

POST login de integraciones

Utilice este punto de conexión para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para integraciones.

URL del endpoint

Utilice las siguientes URL para realizar una solicitud con este punto final:

URL: https://{NEW_DOMAIN}/restaurants/auth/v1/token/login/integrations

Propiedades del endpoint

Este recurso tiene las siguientes propiedades:

Cuerpo de la solicitudjson
Cuerpo de la respuestajson

Parametros

Este endpoint no permite parámetros adicionales.

Codigos de respuesta

Estos son los posibles códigos de estado de la respuesta para este endpoint:

Ejemplo de solicitud

Este es un ejemplo de una solicitud de API que utiliza este endpoint:

POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations

Este es un ejemplo de la solicitud:

{ "client_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd", "client_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW" }

Esta tabla describe los atributos que requiere el JSON de su solicitud:

AtributosRequeridoDescripcion
client_idstringtrueClient Id de tus credenciales de Rappi.
client_secretstringtrueClient Secret de tus credenciales de Rappi.

URL url = new URL("https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setDoOutput(true); final String jsonInputString = "{\n" + " \"client_id\":\"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd\",\n" + " \"client_secret\":\"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW\"\n" + "}"; try (OutputStream os = connection.getOutputStream()) { byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8); os.write(input, 0, input.length); } try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder response = new StringBuilder(); String responseLine; while ((responseLine = br.readLine()) != null) { response.append(responseLine.trim()); } System.out.println("Response body: " + response.toString()); } System.out.println("Response Code : " + connection.getResponseCode());



Ejemplo de respuesta

Este es un ejemplo de la respuesta:

{ "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp", "token_type": "Bearer", "expires_in": 86400 }

Esta tabla describe los objetos contenidos en el ejemplo de respuesta:

Response ObjectObject Description
access_tokenstringToken de acceso para acceder a endpoint seguros.
token_typestringTipo de token.
expires_inintegerTiempo de validez del token en segundos.

POST login de utlis

Utilice este punto final para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para utilidades.

URL del endpoint

Utilice las siguientes URL para realizar una solicitud con este endpoint:

URL: https://{NEW_DOMAIN}/restaurants/auth/v1/token/login/utils

Propiedades del endpoint

Este recurso tiene las siguientes propiedades:

Cuerpo de la solicitudjson
Cuerpo de la respuestajson

Parametros

Este endpoint no permite parámetros adicionales.

Codigos de respuesta

Estos son los posibles códigos de estado de la respuesta para este endpoint:

Ejemplo de solicitud

Este es un ejemplo de una solicitud de API que utiliza este endpoint:

POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations

Este es un ejemplo de la solicitud:

{ "client_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd", "client_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW" }

Esta tabla describe los atributos que requiere el JSON de su solicitud:

AtributosRequeridoDescripcion
client_idstringtrueClient Id de tus credenciales de Rappi.
client_secretstringtrueClient Secret de tus credenciales de Rappi.

URL url = new URL("https://api.dev.rappi.com/restaurants/auth/v1/token/login/utils"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setDoOutput(true); final String jsonInputString = "{\n" + " \"client_id\":\"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd\",\n" + " \"client_secret\":\"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW\"\n" + "}"; try (OutputStream os = connection.getOutputStream()) { byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8); os.write(input, 0, input.length); } try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder response = new StringBuilder(); String responseLine; while ((responseLine = br.readLine()) != null) { response.append(responseLine.trim()); } System.out.println("Response body: " + response.toString()); } System.out.println("Response Code : " + connection.getResponseCode());



Ejemple de respuesta

Este es un ejemplo de la respuesta:

{ "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp", "token_type": "Bearer", "expires_in": 604798 }

Esta tabla describe los objetos contenidos en el ejemplo de respuesta:

Response ObjectObject Description
access_tokenstringToken de acceso para acceder a endpoint seguros.
token_typestringTipo de token.
expires_inintegerTiempo de validez del token en segundos.