The API sells nothing of its own: a key acts with its organization's plan, exactly like the Floweet app for the member it acts for. Some modules are reserved to some plans, and the pitch is written by AI only with a live key.
What each plan opens
| Module | Minimum plan | Operations |
|---|---|---|
companies | Freemium | v1SearchCompaniesv1GetCompany |
simulation | Pack Simulation | v1ListSimulationsv1CreateSimulationv1GetSimulationv1UpdateSimulationv1GenerateSimulationPitch |
stations | Pro | v1ListFuelStationsv1GetFuelStation |
charging | Pro | v1ListChargingStationsv1GetChargingStation |
| — | Any | v1GetBarometerv1GetCheapestFuelStationsv1ComputeFleetCostv1ListProspectsv1CreateProspectv1GetProspectv1ReplaceProspectv1DeleteProspectv1Geocodev1ComputeRoute |
Plans go from Freemium to Enterprise, in this order: Freemium, Pack Simulation, Pro, Enterprise. A plan also opens the modules of the plans before it.
Module outside the plan
An operation whose module is not in the organization's plan answers 403 plan_required, with the module and the minimum plan in the details. Nothing is read or written.
{
"error": {
"code": "plan_required",
"message": "This module is not included in your organization's plan.",
"details": {
"module": "stations",
"tier": "PRO"
}
}
}To open it, change the organization's plan, or write to us at contact@floweet.com.
The pitch and AI
Writing a simulation's pitch is the only operation that may call an AI model:
- with an
fw_live_key, AI writes the pitch; if it does not answer, or if the organization's daily cap of AI pitches is reached, the template takes over; - with an
fw_test_key, the pitch always comes from the template: no AI call is made; - the response's
generatorfield says which one wrote it:geminiortemplate; - the pitch is written in the Accept-Language language and saved on the simulation: it replaces the previous one, and the app shows it.