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 start exploring 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 click on Authorize:
- Click on Authorize again and log in to your site with a username and password (OAuth).
- When the authorization completes, close the dialog box in the Swagger interface and start exploring the API!
If you're running FotoWare on-premises
If you're running an on-premises version of FotoWare, you will need to register the FotoWare API site as an application in the OAuth section on your FotoWare site before you can authorize a connection:
Open the Operations Center on the FotoWare server and go to the FotoWare site configuration. On the Settings tab, find the Applications node and click on the button labeled Add application.
Fill in the following values (see screenshot)
- Type: Native
- Scope: API
- Client ID: 4d71615a-3bce-457a-a57c-3b5e54dcd075
- Redirect URI: https://api.fotoware.com/oauth2-redirect.html
Enabling CORS
You will need to 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's URL to the Site field at the top of the screen and click on Authorize:
- Click on Authorize again and log in to your site with a username and password (OAuth):
- When the authorization completes, close the dialog box in the Swagger interface and start exploring the API!