February 22nd 2023 Release Note: RME: GET API Base URL Change - *Action Required Before Feb 22nd*

Summary

Release date: February 22nd 2023

Change of Base URL for Certain GET Requests

• Enabled by Default? - Yes
• Set up by customer Admin? - No
• Enable via Support ticket? - No
• Affects configuration or data? - Yes

What's Changing?

The base URLs for certain GET requests will soon be deprecated. New replacement URLs have been introduced.

Reason for the Change

Increased security.

Customers Affected

All customers using API requests with these base URLs.
A full list of GET requests that will be impacted by this change can be found towards the bottom of this release note. 

Release Note Info/Steps

What Action is Required?

• By February 22nd 2023, the new URL must be used when making the specified GET requests

Old URLs

• EMEA - http://api.starchef.net/v2/{resource}
• North America - http://api.recipe.na1.fourth.com/{resource}

After February 22nd 2023, requests will not work with these old URLs.

New URLs

• EMEA - https://api.fourth.com/api/rmegetapi/{resource}
• North America - https://api.na1.fourth.com/api/rmegetapi/{resource}

The new base URLs are available now and can be used with existing usernames and passwords - though users will have to manually enter credentials when signing in for the first time.

Please note that none of the responses will change as a result of this base URL change.

Using the New URL

• Using a web browser, enter the new base URL with the specified resource
  • Example request with old base URL (EMEA region) - http://api.starchef.net/v2/ingredients
  • Example request with new base URL (EMEA region) - https://api.fourth.com/api/rmegetapi/ingredients

• Enter the API user's Username and Password and then Sign in
• If prompted, save the username and password

The request will then proceed.

Fig.1 - New URL and sign-in pop-up

Additional Resources

Recipe & Menu Engineering Export API Guide | Fourth

If you have any questions about this change, please feel free to scroll down and leave a public comment on this release note and Fourth will post a response.

GET Requests Impacted by this Change

GET Categories
/category/Ingredient
/category/Menu
/category/Recipe

GET Groups
/admingroups
/groups

GET Ingredients
/ingredients
/ingredients/{guid}
/ingredients/{guid}/groups
/ingredients/{guid}/intolerances
/ingredients/intolerancehistory
/ingredients/{guid}/intolerancehistory
/ingredients/{guid}/nutrition
/ingredients/{guid}/pictures
/ingredients/{guid}/processdata
/ingredients/{guid}/supplierspec
/ingredients/{guid}/fullIngredientListHistory
/ingredients/fullIngredientListHistory
/ingredients/customfields
/ingredients/{guid}/customfields

GET Recipes
/recipes
/recipes/{guid}
/recipes/{guid}/intolerances
/recipes/{guid}/nutrition
/recipes/{guid}/pictures
/recipes/{guid}/preparation
/recipes/{guid}/groups
/recipes/intolerancehistory
/recipes/{guid}/intolerancehistory
/recipes/fullingredientlisthistory
/recipes/{guid}/fullingredientlisthistory

GET Menus
/menus
/menus/{guid}
/menus/{guid}/groups
/menuguids

GET Suppliers
/suppliers

GET Units
/units

GET Intolerances
/intolerances

GET Nutrients
/nutrients

GET Exports
/Exports/ingredients/{guid}
/Exports/recipes/{guid}
/Exports/ingredientDaily
/Exports/RequestStatus/{export_id}
/Exports/download/{export_id}