API 2.0 - Harder, Better, Faster, Stronger - Smart Benchmarks

You've been waiting for it, and it's finally here! And it brings a lot of new features! Click here to access the complete v2.0 changelog.

New Developer Website

The website has also been redesigned and will replace the current one at the same address (https://developers.upply.com).

New Features in the API

This overhaul also comes with a range of features, both in terms of direct functionality and user-related capabilities!

🙋 New user and company functionalities:

• Users will no longer need to provide the email of someone from their company to use the API; the key (also called token) will suffice!
• A company can create as many keys as necessary (example use case: one for the team located in France, another for the team located in the UK, etc.).
• Each key will have a label for recognition in Analytics or Consumption tracking, for example, "Team France," "Team UK," or "Prod," "Preprod," etc.
• A key can be revoked and deactivated in case of any client issues or disputes.
• For Analytics enthusiasts, the entities called by the API will have a source api2 in the data.

🧪 New model functionalities:

• The Road Europe model is renamed to Road EMEA (Europe, Middle East & Africa) #teasing
• Calls to Road EMEA and Road NA will return the distance (in km or miles).
• Calls to all models will return the CO2 consumption.
• Road EMEA calls will now be synchronized with the website and will benefit from:
  • The truck type and cargo type are now well synchronized with the website.
  • Addition of dangerous goods to enable/disable.
  • Addition of fuel surcharge to enable/disable.
• Road NA calls will now be synchronized with the website and will benefit from:
  • The ability to include contracts in the analysis (choice: either spot or spot+contract).
  • Addition of fuel surcharge to enable/disable.
• Air calls will now be synchronized with the website and will benefit from:
  • Choice of industry (similar to the latest website update).
  • Addition of Reefer to enable/disable.
  • Addition of Hazardous to enable/disable.
  • Addition of Customs to enable/disable.
  • Refresh of service types (ata, dtd, etc.) and service levels (eco, express, standard).
• Sea calls will now be synchronized with the website and will benefit from:
  • Addition of Hazardous to enable/disable.
  • Refresh of service types (ptp, dtd, etc.).
  • Addition of THC origin and destination.

Technical Enhancements

It's not just about adding new features but also about removing a massive technical debt that has accumulated over the years. Here are the technical and architectural improvements that have been made:

• Departure from the Azure API Management tool that limited scalability.
• Creation and management of the API directly in Go within our technical stack.
• Increased number of requests per second without errors: from 4 r/s to 12.5 r/s (max historical client: 5.5 r/s).
• Automated testing and continuous integration for easy updates in case of advancements and easy rollback in case of errors.
• Improved infrastructure management now linked and integrated with our stack, ensuring better scalability and responsiveness of services in case of increased calls.
• Standardized message format received from and sent to clients to comply with API industry norms.
• Storage of metadata for efficient analytics tracking.
• Field renaming for business harmonization across different services.
• "Ping" API to allow clients to test authentication only and validate their access.
• Test environment (sandbox) under construction, which will be available for Smart and Connect.