Es wäre toll, wenn die zugehörige OpenAPI-Spezifikation zu eurer API abrufbar wäre, damit man sich damit einfacher einen Client generieren kann.
Hallo,
Ja das ist in Planung, die neue API die kommt hat eine komplette OpenAPI Spezifikation. Diese wird aber erst im Herbst freigegeben wenn das letzte Modul (CRM) fertig ist.
lg
Alex
Auf der neuen Website wird die OpenAPI-Spec bereits beworben:
Gibt es sie jetzt doch schon irgendwo vorab oder doch erst im Herbst? Bei letzterem solltet ihr das vielleicht noch nicht so groß bewerben … 🫣
Hi,
Die neue API ist unter https://docs.campai.com/developer zu sehen 😃 Momentan gibts leider noch zwei je nach Funktion aber bald nur noch eine
Ich hoffe, wir reden hier nicht aneinander vorbei 😄
Ich meinte mit diesem Ticket die OpenAPI-Spezifikation (früher Swagger) als JSON- oder YAML-Datei: https://spec.openapis.org/oas/latest.html
Die API-Doc auf docs.campai.com wird von derselben Swagger OpenAPI json gespeist
Ah, super! 😍 Aber öffentlich verlinkt ist die JSON noch nicht, oder bin ich blind? 😅
Nein da wir die in unserer Docs rendern weil wir den original Swagger-Renderer ned so toll fanden 😉
Für was würde man die JSON direkt gebrauchen meinst du?
Damit kann man sich wunderbar API-Clients mit diversen Tools bauen lassen, damit man sich nicht händisch mit den Requests und den Typen rumärgern muss. Wir nutzen das auf Arbeit auch intensiv inkl. unserer Kunden.
Von Swagger selbst z.b. für gefühlt alle Sprachen, aber auch separat jeweils einige je Sprache.
Macht sinn dann nehme ich den Link in die Doku auf 😃