Product schedules by SKU
Use the Utils resource to manage the Schedules configured in your stores.
The following table describes the different contents of the Schedules Utils resource:
Resource | Description |
---|---|
GET sku/corridor/{corridorId}/integration/{integrationId} | Returns the collection of products for the corridor and store |
GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId} | Returns the product schedules configured for the corridor and store |
POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId} | Create product schedules for the corridor and store |
PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId} | Update product schedules for the corridor and store |
DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId} | Use this endpoint to delete product schedules configured for the corridor and store. |
GET sku/corridor/{corridorId}/integration/{integrationId}
Use this endpoint to retrieve the collections of products configured for the given corridor and store.
Endpoint URL
Use this URL to make a request with this endpoint:
https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/corridor/{corridorId}/integration/{integrationId}
{COUNTRY_DOMAIN}
: This is your Rappi Country Domain. See the list of Country Domains.{integrationId}
: This is the identifier of your store.{corridorId}
: This is the identifier of the corridor.
Sample Request
This is an example of an API request using this endpoint:
GET https://microservices.dev.rappi.com/api/rest-ops-utils/sku/corridor/123/integration/888
This is an example of the request:
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/corridor/123/integration/888"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); 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());
Endpoint Properties
This resource has the following properties:
Response formats | JSON |
Authentication requirements | Token |
Parameters
This endpoint does not permit additional parameters.
Status Codes
These are the possible status codes of the response for this endpoint:
Sample Response
This is an example of the response:
[ { "sku": 789, "name": "Americano Caliente 16 oz", "description": "16 oz. Espresso con agua caliente.", "corridor_id": 123, "integration_id": "888" }, { "sku": 987, "name": "Americano Caliente 20 oz", "description": "20 oz. Espresso con agua caliente.", "corridor_id": 123, "integration_id": "888" } ]
This table describes the objects contained in the response example:
Response Object | Object Description |
---|---|
sku integer | Identifier of the product. |
name string | Name of the product. |
description string | Description of the product . |
corridor_id integer | Identifier of the corridor. |
integration_id string | Identifier of the store that contains the corridor. (The parent store identifier in case of child store request) |
GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
Use this endpoint to obtain product schedules configured for the corridor and store.
Endpoint URL
Use this URL to make a request with this endpoint:
https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
{COUNTRY_DOMAIN}
: Your Rappi Country Domain. See the list of Country Domains.{integrationId}
: This is the identifier of your store.{corridorId}
: This is the identifier of the corridor.{sku}
: This is the identifier of your product.
Endpoint Properties
This resource has the following properties:
Response formats | JSON |
Authentication requirements | Token |
Parameters
This endpoint does not permit additional parameters.
Status Codes
These are the possible status codes of the response for this endpoint:
Sample Request
This is an example of an API request using this endpoint:
GET https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
This is an example of the request:
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); 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());
Sample Response
This is an example of the response:
{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 4, "days": "mon,tue,wed,thu,fri,sat,sun,hol", "starts_time": "08:00:00", "ends_time": "23:00:00" } ] }
This table describes the objects contained in the response example:
Response Object | Object Description |
---|---|
sku integer | Identifier of your product. |
corridor_id integer | Identifier of the corridor. |
integration_id integer | Identifier of your store. (The parent store identifier in case of child store request) |
schedule_details array of objects | List of the schedules where product must be available. |
schedule_details.id integer | Identifier of the product schedule. |
schedule_details.days string | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time string | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time string | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |
POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
Use this endpoint to create schedules for your products in the corridor and store.
Endpoint URL
Use this URL to make a request with this endpoint:
https://{COUNTRY_DOMAIN}api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
{COUNTRY_DOMAIN}
: Your Rappi Country Domain. See the list of Country Domains.{integrationId}
: This is the identifier of your store.{corridorId}
: This is the identifier of the corridor.{sku}
: This is the identifier of your product.
Endpoint Properties
This resource has the following properties:
Response formats | JSON |
Request body requirements | JSON |
Authentication requirements | Token |
Parameters
This endpoint does not permit additional parameters.
Status Codes
These are the possible status codes of the response for this endpoint:
Sample Request
This is an example of an API request using this endpoint:
POST https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888
This is an example of the request:
{ "schedule_details": [ { "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "08:00:00", "ends_time": "20:00:00" }, { "days": "hol", "starts_time": "13:00:00", "ends_time": "22:00:00" } ] }
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); 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.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); connection.setDoOutput(true); String jsonInputString = "{\n" + " \"schedule_details\": [\n" + " {\n" + " \"days\": \"mon,tue,wed,thu,fri,sat,sun\",\n" + " \"starts_time\": \"08:00:00\",\n" + " \"ends_time\": \"20:00:00\"\n" + " },\n" + " {\n" + " \"days\": \"hol\",\n" + " \"starts_time\": \"13:00:00\",\n" + " \"ends_time\": \"22:00:00\"\n" + " }\n" + " ]\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());
This table describes the attributes that the JSON
of your request requires:
Attributes | Requirement | Description |
---|---|---|
schedule_details array of objects | required | List of the schedules for the given product. |
schedule_details.days string | required | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time strings | required | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time strings | required | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |
Sample Response
This is an example of the response:
{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "08:00:00", "ends_time": "20:00:00" }, { "id": 6, "days": "hol", "starts_time": "13:00:00", "ends_time": "22:00:00" } ] }
This table describes the objects contained in the response example:
Response Object | Object Description |
---|---|
sku integer | Identifier of your product. |
corridor_id integer | Identifier of the corridor. |
integration_id integer | Identifier of your store. (The parent store identifier in case of child store request) |
schedule_details array of objects | List of the schedules where product must be available. |
schedule_details.id integer | Identifier of the product schedule. |
schedule_details.days string | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time string | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time string | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |
PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
Use this endpoint to update schedules for your products in the corridor and store.
Endpoint URL
Use this URL to make a request with this endpoint:
https://{COUNTRY_DOMAIN}api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}
{COUNTRY_DOMAIN}
: Your Rappi Country Domain. See the list of Country Domains.{integrationId}
: This is the identifier of your store.{corridorId}
: This is the identifier of the corridor.{sku}
: This is the identifier of your product.
Endpoint Properties
This resource has the following properties:
Response formats | JSON |
Request body requirements | JSON |
Authentication requirements | Token |
Parameters
This endpoint does not permit additional parameters.
Status Codes
These are the possible status codes of the response for this endpoint:
Sample Request
This is an example of an API request using this endpoint:
PUT https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888
This is an example of the request:
{ "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "10:00:00", "ends_time": "16:00:00" } ] }
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("PUT"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); connection.setDoOutput(true); String jsonInputString = "{\n" + " \"schedule_details\": [\n" + " {\n" + " \"id\": 5,\n" + " \"days\": \"mon,tue,wed,thu,fri,sat,sun\",\n" + " \"starts_time\": \"10:00:00\",\n" + " \"ends_time\": \"16:00:00\"\n" + " }\n" + " ]\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());
This table describes the attributes that the JSON
of your request requires:
Attributes | Requirement | Description |
---|---|---|
schedule_details array of objects | required | List of the schedules for the given product. |
schedule_details.id integer | required | Identifier of the product schedule. |
schedule_details.days string | required | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time strings | required | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time strings | required | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |
Sample Response
This is an example of the response:
{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "10:00:00", "ends_time": "16:00:00" } ] }
This table describes the objects contained in the response example:
Response Object | Object Description |
---|---|
sku integer | Identifier of your product. |
corridor_id integer | Identifier of the corridor. |
integration_id integer | Identifier of your store. (The parent store identifier in case of child store request) |
schedule_details array of objects | List of the schedules where product must be available. |
schedule_details.id integer | Identifier of the product schedule. |
schedule_details.days string | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time string | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time string | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |
DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}
Use this endpoint to delete product schedules configured for the corridor and store.
Endpoint URL
Use this URL to make a request with this endpoint:
https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}
{COUNTRY_DOMAIN}
: Your Rappi Country Domain. See the list of Country Domains.{corridorProductScheduleId}
: This is the identifier of the product schedule.{integrationId}
: This is the identifier of your store.{corridorId}
: This is the identifier of the corridor.{sku}
: This is the identifier of your product.
Endpoint Properties
This resource has the following properties:
Response formats | JSON |
Authentication requirements | Token |
Parameters
This endpoint does not permit additional parameters.
Status Codes
These are the possible status codes of the response for this endpoint:
Sample Request
This is an example of an API request using this endpoint:
DELETE https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}
This is an example of the request:
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888/254"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("DELETE"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); 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());
Sample Response
This is an example of the response:
{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 4, "days": "mon,tue,wed,thu,fri,sat,sun,hol", "starts_time": "08:00:00", "ends_time": "23:00:00" } ] }
This table describes the objects contained in the response example:
Response Object | Object Description |
---|---|
sku integer | Identifier of your product. |
corridor_id integer | Identifier of the corridor. |
integration_id integer | Identifier of your store. (The parent store identifier in case of child store request) |
schedule_details array of objects | List of the schedules that are still available. |
schedule_details.id integer | Identifier of the product schedule. |
schedule_details.days string | Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol". |
schedule_details.starts_time string | A specific time where the product begins to be available for users. 24 hour format HH:mm:ss |
schedule_details.ends_time string | A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss |