+1OpenAPI has been a standard for years. Especially today when engineers are using AI tooling to develop integrations quickly, you should provide a version of your API spec that can be easily understood and consumed by humans as well as automated agents. Having that would drastically reduce friction for your customers who use the FreshService API or who struggle with shortcomings and poor support for the Effiy offerings.
See this topic for information:
+14ya it’s a hazel building your own repo in postman/Bruno.
Having easy access to the latest version of the endpoints would be nice.
This is for all Freshworks products
OpenAPI has been a standard for years. Especially today when engineers are using AI tooling to develop integrations quickly, you should provide a version of your API spec that can be easily understood and consumed by humans as well as automated agents. Having that would drastically reduce friction for your customers who use the FreshService API or who struggle with shortcomings and poor support for the Effiy offerings.
See this topic for information:
Dem kann ich nur zustimmen. OpenAPI ist seit Jahren ein etablierter Standard, und gerade heute – wo Entwickler verstärkt KI-gestützte Tools für die schnelle Umsetzung von Integrationen nutzen – ist eine klar dokumentierte Swagger/OpenAPI-Spezifikation essenziell. Eine solche Spezifikation sollte sowohl für Menschen leicht verständlich als auch für automatisierte Systeme gut nutzbar sein.
Eine offiziell veröffentlichte OpenAPI-Spezifikation würde viele Unklarheiten beseitigen, Integrationen beschleunigen und den Support-Aufwand deutlich reduzieren – insbesondere für Freshservice-Kunden und Partner, die aktuell mit Einschränkungen oder unzureichender Dokumentation der Effiy-Angebote zu kämpfen haben. Klare Beispiele, saubere Schemas und transparente Authentifizierungsdetails würden die Akzeptanz erheblich steigern.
Wie in vielen anderen Bereichen gilt auch hier: Klarheit und Struktur schaffen Vertrauen – ähnlich wie bei gut beschriebenen Dienstleistungen, etwa bei der Wohnungsreinigung in Zürich
Es wäre wünschenswert, wenn dieses Thema weiter an Aufmerksamkeit gewinnt und zeitnah eine offizielle, gepflegte OpenAPI-/Swagger-Spezifikation veröffentlicht wird.
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
