Exploring the Fotoware API with Swagger
Public documentation of the Fotoware endpoints with Swagger (OpenAPI) is available at https://api.fotoware.com. Using this site, you can authorize the site's connection to your Fotoware SaaS tenant and explore the entire API.
If you're using Fotoware as a Service
- Go to https://api.fotoware.com
- Add your Fotoware tenant's URL to the Site field at the top of the screen and select Authorize:
- Select Authorize again and log in to your site with a username and password (OAuth).
- When the authorization is complete, close the dialog box in the Swagger interface and explore the API!
If you're running Fotoware On-Premises
If you're running an on-premises version of Fotoware, you need to register the Fotoware API site as an application on your Fotoware site before you can authorize a connection:
- From the Tools menu (cogwheel icon), go to Site Configuration > Integrations > Applications.
- Select Add application.
- Enter the following values:
- Type: Native
- Scope: API
- Client ID: 4d71615a-3bce-457a-a57c-3b5e54dcd075
- Redirect URIs: Select Add to enter the redirect URI: https://api.fotoware.com/oauth2-redirect.html
- Select Save.
Enabling CORS
You must enable CORS for the origin https://api.fotoware.com. Here's how:
After registering the application and enabling CORS
Having registered the application on your Fotoware site and made the necessary CORS adjustments, authorize the Fotoware API:
- Go to https://api.fotoware.com
- Add your Fotoware site URL to the Site field at the top of the screen and select Authorize:
- Select Authorize again and log in to your site with a username and password (OAuth):
- When the authorization is complete, close the dialog box in the Swagger interface and explore the API!