Azure Developer Portal

The Azure API Management (APIM) Developer Portal lets you discover, explore, and test Equation APIs directly in your browser. It is primarily for developers who need quick access to documentation without installing any client tools.

What You Can Do

• View live API documentation generated from the imported OpenAPI spec
• Inspect request / response schemas and example payloads
• Try endpoints interactively ("Try it" panel)
• Authenticate using Azure Entra ID (sign in)

✅ When to Use the Portal

Use the portal to:

• Confirm an operation exists
• Read parameter definitions quickly
• Perform a one‑off manual request

Use another client (Excel, Grasshopper, Python package, WaterFuser) for repeat calculations, workflow integration, or larger automated scenarios.

🚀 Access

Production portal: https://equation-production.developer.azure-api.net/

Sign in with your Haskoning Azure Entra ID account, and start by browsing the available APIs.

For Acceptance portal access, you can check Here.

🌍 Trying an Endpoint

1. Navigate to an API and select an operation.
2. Click Try It.
3. Authorization by select the authorization_code(PKCE) from Authorization flow and sign in if prompted.
4. Fill required parameters / body.
5. Send the request and inspect status + response body.

You can also copy code snippets in various languages for use in your own applications by expanding the HTTP request section.

⚙️ Adding your endpoint to Equation

Check the Developers Guide for instructions on how to add your APIs to the Equation platform and have it appear in the Developer Portal.

🛠️ Troubleshooting

Issue	Action
401 Unauthorized	Check login; ensure Authorization header key present
404 Not Found	Operation missing in APIM; regenerate + re-import OpenAPI spec

If an operation is missing here, fix the OpenAPI spec first (see Developers Guide). The portal always reflects the imported spec — it does not generate routes itself.