API addresses
Every satellite's API addresses for production and staging in one table, and which ones have a short alias on api.bifrostorbit.com.
Reference3 min read
Bifröst Orbit has two hosts for each stage:
app.bifrostorbit.comstage.bifrostorbit.comapi.bifrostorbit.comapi-stage.bifrostorbit.comStaging is a separate copy, with its own organisations, data and keys. A production key doesn't work on staging.
Every address
Swap app. for stage. and api. for api-stage. to reach staging.
https://api.bifrostorbit.com/cms/v1https://api.bifrostorbit.com/cms/graphqlhttps://api.bifrostorbit.com/cms/manage/v1https://api.bifrostorbit.com/cms/preview, https://api.bifrostorbit.com/cms/bridge.jshttps://api.bifrostorbit.com/cms/uploads/…https://app.bifrostorbit.com/cms/mcphttps://api.bifrostorbit.com/careers/v1https://api.bifrostorbit.com/careers/graphqlhttps://app.bifrostorbit.com/careers/api/v1https://app.bifrostorbit.com/careers/mcphttps://app.bifrostorbit.com/commerce/api/public/{shop address}https://app.bifrostorbit.com/commerce/api/cdn/graphqlhttps://app.bifrostorbit.com/commerce/mcphttps://app.bifrostorbit.com/travel/api/public/{booking name}https://app.bifrostorbit.com/travel/api/cdn/graphqlhttps://app.bifrostorbit.com/travel/mcphttps://app.bifrostorbit.com/booking/api/public/{location's booking name}https://app.bifrostorbit.com/booking/mcphttps://app.bifrostorbit.com/presence/api/public/{business name}/reviewshttps://app.bifrostorbit.com/presence/api/v1/organisations/{organisationId}/requestshttps://app.bifrostorbit.com/presence/mcphttps://api.bifrostorbit.com/insights/v1/https://api.bifrostorbit.com/insights/graphqlhttps://app.bifrostorbit.com/insights/mcpThe shop address, the booking names and the Presence business name are set in each satellite's settings, such as northwilds or northwilds-oslo.
Opening https://api.bifrostorbit.com/ shows the main addresses as JSON. An address that doesn't exist answers 404 with not_found.
Aliases on the app host
The short addresses on api. are aliases. Each also works on the app host under the satellite's own path, and the delivery APIs on the api. host also answer at that path:
api.bifrostorbit.com/cms/v1/…app.bifrostorbit.com/cms/api/cdn/v1/… and api.bifrostorbit.com/cms/api/cdn/v1/…api.bifrostorbit.com/cms/graphqlapp.bifrostorbit.com/cms/api/cdn/graphqlapi.bifrostorbit.com/cms/manage/v1/…app.bifrostorbit.com/cms/api/v1/…api.bifrostorbit.com/careers/v1/…app.bifrostorbit.com/careers/api/cdn/v1/…api.bifrostorbit.com/careers/graphqlapp.bifrostorbit.com/careers/api/cdn/graphqlapi.bifrostorbit.com/insights/graphqlapp.bifrostorbit.com/insights/api/cdn/graphqlUse the short addresses in your code: they are the ones the SDKs and the satellites' docs use. A redirect between them, such as a trailing slash added to an endpoint, costs a second request: leave the trailing slash off API endpoints.
Commerce, Travel, Booking and Presence Orbit have no short addresses on api. yet: call them on the app host.
Orbit itself
Orbit has no public API. Its mobile API, at app.bifrostorbit.com/api/mobile/v1, is only for the Orbit app. See Sign in with Orbit. Orbit Exchange, at api.bifrostorbit.com/exchange/v1, only answers the satellites. See Orbit Exchange.
When a service is restarting
While a satellite restarts, for example during an update, its API answers 503 with unavailable and Retry-After: 15. Wait and try again. Status shows each satellite's health.
Was this page helpful?