@Achim-Fuchs Danke für die Erklärungen.
Ja, das hatte ich befürchtet.

Hast allenfalls php code den du mir zusenden könntest? (Oder wenn es eine andere Sprache ist, dann wäre der Teil zum Auflösen der Wiederholungen + Ausnahmen interessant)
Ich würde ihn dann in diese Projekte hier integrieren und veröffentlichen.

https://github.com/vineyardkoeln/churchtools-api und https://github.com/a-schild/churchtools-pdfcalendar

@fkmm-webmaster Diese Api gibt es bisher noch nicht. Ich denke es wird Sinn machen, die irgendwann einzuführen, aber steht aktuell noch nicht auf dem Plan.

@mriedel Dann trag' doch einfach in den Einstellungen den Mandanten richtig ein:

Unbenannt.png

Alternativ direkt die churchdbsync.ini editieren:

optigem_mandant=01

@JuniOr sagte in API Nutzung, Webseite (Wordpress):

Deswegen vielleicht auch etwas Teils dumme Fragen.

nur keine Scheu! 😉
Hier hilft man gerne und i. d. R. auch recht zügig.

Vielen Dank für die beiden Antworten.

@hbuerger Ich kann die Schätzung gut nachvollziehen. Alles klar.
@aschild Ich hatte bereits eure REST-API gesehen. Da ich aber mit NodeJS direkt mit der offiziellen API rede, ist für mich PHP keine Option. Ich könnte mir eher vorstellen, einen ähnlichen Wrapper für Node anzubieten (abhängig davon, wieviel andere Schnittstellen ich noch ansprechen werde)

Dann werde ich erstmal die alte API ausprobieren.

Als Hoster Info an den Support, als Selfhoster kann man das selber eintragen.

@davidschilling sagte in Fehler in openapi.json definition der privacyPolicyAgreement?:

Wenn ich das richtig sehe ist das ein PHP Problem 🙂

Also, normalerweise kommt da ein Objekt zurück, aber wenn das leer ist kommt ein Array zurück.

Das liegt daran, dass in PHP Arrays auch als Maps verwendet werden.

Beispiel:

Map: ['foo' => 'bar']
Array: ['bar']

Wenn jetzt die Map oder das Array leer sind sehen beide so aus: []
Das führt dazu, dass beim Konvertieren der Struktur ein Array bei einer leeren Map rauskommt.
Ich hab das jetzt nicht überprüft, aber sieht mir stark nach dem Problem aus.

So wie ich das sehe, passend hier Definition und Rückgabewert nicht zusammen, wenn bei der Person keine privacyPolicyAgreement gespeichert ist.

Die Definition erwartet ein Objekt mit den 3 properties date/typeId/whoId, die zwar alle null sein dürfen, aber das objekt selbst sollte in der JSON Anwort daherkommen.

Wenn keine privacyPolicyAgreement vorhanden ist, dann sollte doch das Feld privacyPolicyAgreement als Nullable definiert sein und auch als null zurückgeliefert werden...

Wir als Schweizer dürfen dieses Feld glücklicherweise noch für 2-3 Jahre ignorieren, daher ist es bei uns noch Leer und führt zu diesem Stolpern...

@andrea-schulz sagte in API für Dummies:

Hallo
Ich finde die hier diskutierte API Themen super spannend. Da gibt es also noch unendlich viele Möglichkeiten... Kann vielleicht jemand mal ein Webinar „API für Dummies“ anbieten und das ein bisschen vorstellen?

@andrea-schulz Die API ist für Softwareentwickler gedacht. Da bringt eigentlich ein solches Webinar vermutlich nicht viel.
Als SW Entwickler ist die Doku sehr gut und man kann damit eigentlich sofort loslegen.
Aktuell hat es noch einige Kinderkrankheiten, aber da wurde schon einiges Ergänzt/Korrigiert 🙂

Noch ein weiteres Feld welches NULL sein darf:

/groups/{id}/members/ ->memberEndDate string($date) -> nullable

Das Ende der Gruppenteilnahme ist ja sehr oft noch leer 😉

@DNie sagte in Frage zu einem API-Call des Kalenders:

@aschild sagte in Frage zu einem API-Call des Kalenders:

https://github.com/vineyardkoeln/churchtools-api

Was macht man, wenn man nicht mit PHP unterwegs ist? Ich verstehe nicht, warum der Kalender noch nicht über die REST API abrufbar ist. Ist doch essenziell. Warum die Templates, aber die Events nicht?

Weil Gott die Welt auch nicht an einem Tag schuf? 😉

Die REST Api wurde im ersten Schritt gestartet um die App anbinden zu können, darum waren zuerst nur Personen und Dienste in der neuen Api zu finden.

In der Zwischenzeit ist vieles dazu gekommen aber der Kalender noch nicht.

Und wenn du nicht mit PHP unterwegs bist, du kannst die alte API ja trotzdem nutzen, musst halt mehr Wrappercode selber schreiben...

Die Doku dazu findest du hier:
https://api.church.tools/class-CTChurchCalModule.html
und als Funktion wirst du wohl getCalendarEvents benötigen.

Wie man die alte API nutzt, musst/kannst du dann im php code "spicken"

ok, danke für die Info.
Dann hätte ich noch eine andere (Off-Topic-)Frage:
Welche Bedeutung hat die Eigenschaft "valid_yn" bei den "services" wenn ich über die alte API "getAllEventData" aufrufe?

@holunder
Wir haben glaub nicht die aktuelle Version auf der Homepage laufen.

@rena Da ich das damals primär über die Konsole ausgeführt habe, weil das bisschen zu viele Lieder waren bei uns, hatte ich normale Zeilenumbrüche \n rein gemacht und keine <br>.. aber ja.. vll. kann man das ja konditional oder beides machen.. 🙂

@philipptrenz Das ist richtig tolle Arbeit!

Da bei uns die Fakten die Ordner eintragen, wäre es für uns besser, sowas in einer Intranet-Seite zu haben und über einen Raspberry oder eine NAS hosten zu lassen. Am besten auch schön responsive, dass jeder Ordner es auf seinem Handy nutzen kann.

Aber als Eigenentwicklung an sich: Hut ab! Weiter so!

@Silas-K sagte in Beispiel Login REST API:

Nachtrag:
Bzw. Anders gefragt, von wo darf denn ein Zugriff auf die API stattfinden, wenn Postman es schafft, aber meine PWA nicht?

Kurze Ergänzung dazu. CORS (Mozilla MDN) ist ein Schutzmechanismus im Web. Ganz einfach gesprochen: Der Browser verhindert das nachladen von Daten (Skripts, CSS, API Calls, etc.) wenn der Origin (in diesem Fall ChurchTools) diese Seite nicht explizit das Laden erlaubt. Damit soll verhindert werden, dass im Frontend Schadcode von fremden Quellen einfach so geladen werden kann.

Wenn du PHP verwendest, dann läuft das auf einem Server. Backend also hier kannst du die ChurchTools API ohne Probleme aufrufen. Dass dein Server gehackt wurde und Schadecode ausliefert ist eher unwahrscheinlich.

Es lohnt sich das Thema CORS anzugucken. So ist es doch ein wichtiges Sicherheitskonzept im Web.

Nein, du bist nicht blind. Diese Filterfunktion nach Bereich gibt es zurzeit noch nicht.