API FAQ

What is ISO8601 format?

Source: https://en.wikipedia.org/wiki/ISO_8601

Can I export the API calls/schemas?

Yes. Download the API in JSON format from Swagger on your SMA or ESA:

http://[hostname]/swagger/swagger-sma.json

http://[hostname]/swagger/swagger-esa.json

1. Save the JSON locally or directly use the Import option of your 3rd-party application (Postman, Insomnia).
2. At the base level of the new collection, for Authorization, you will need to assign the authorization type to Basic Auth and use your username/password or assign the authorization type to API Key and create a jwtToken for use FROM your 3rd-party application TO the appliance.
3. For Variables, update the baseURL for the CURRENT VALUE as your appliance HTTPS:

https://[hostname].iphmx.com

Example URL, if Cisco Secure Email Cloud Gateway customer

4. Save the changes to the base level of your collection.
5. You can now use a test example to confirm the API call succeeds. Expand and select the config folder, and select the get sdr categories.
6. For Authorization, assure the type is "Inherit auth from parent".
7. Click Send.
8. You should now see results similar to: