RESTful API: Vorstellung

MaBo

@narnitz sagte in RESTful API: Vorstellung:

churchwiki/ajax

Danke für die flotte Hilfe. Leider bin ich mit der alten API verloren... Ich werde mit https://api.church.tools/ einfach nicht warm.

Gibt es jmd, der mich etwas abholen kann oder eine umfassende Doku?

narnitz

@MaBo Nutzt du den ChurchTools JS Client?

MaBo

@narnitz
Nope, python. Doch der JS Client unterstützt (wie ich verstanden habe) die alte API nicht. Sonst würde mir das als Basis reichen.

Und mit php (https://github.com/5pm-HDH/churchtools-api) bin ich nicht fit genug...

narnitz

@narnitz Generell kannst du dir auch die Request einfach mal anschauen, die abgeschickt wird, wenn du eine Wikiseite speicherst:
Beispielsweise beim Bearbeiten einer Wikiseite ist das:
Ein POST an https://instanzName.church.tools/?q=churchwiki/ajax
Mit dem Cookie und Csrf-Token als Header (hier sollte aber auch ein login token gehen, siehe https://hilfe.church.tools/wiki/0/API Authentifizierung und https://hilfe.church.tools/wiki/0/API-CSRF

Und der Request Body ist dann das JSON, das auch oben schon steht.

narnitz

@MaBo Doch, das tut er.

Das müsste mit churchToolsClient.oldApi('churchwiki/ajax') gehen.

@jziegeler könntest du hier vllt. noch einen Tipp geben?

MaBo

Moin @narnitz , ich bin schon ein ganzes Stück weiter. Leider habe ich lange nicht mitbekommen, dass meine requests wegen der 2-FA nicht erfolgreich waren.

Kaum habe ich einen Testuser genutzt, kam ich durch. Nun hänge ich "nur" noch daran, dass er keine Berechtigungen haben soll (BasicAuth+Cookies, CSRF und Token hab ich schon versucht, mal sehen was da fehlt).

Auf jeden Fall: DANKE für die Unterstützung, die hat mich weiter gebracht!

narnitz

@MaBo du kannst mit der neuen API mit /api/login und /api/totp dich authentifizieren können. Danach kannst du dir auch deinen Login Token über den endpoint (der mir gerade nur leider nicht einfällt) rauslassen.

Die Dokumentation zur REST api findest du wie gewohnt unter https://deineinstanz.church.tools/api

MaBo

@narnitz merci

noch hab ich das mit TOTP nicht zum laufen bekommen, doch der rest funktioniert super.

(wer genauers wissen will kann hier schauen: GitHub - ChurchTools-song-checker)

Nun aber genug mit OT

MarcelNono

Ist es geplant die REST API für Routinen und Routinen bestimmter Gruppen hinzuzufügen? Ich würde gerne mittels py script Routinen ausführen. Auf diesem Weg versuchen wir Newsletter mit Abmeldelinks umzusetzen.

jziegeler

@MarcelNono die sind bisher noch nicht dokumentiert, aber schon umgesetzt. Einfach den netzwerktab anschauen und mit den Routinen arbeiten, dann siehst du wie sie funktionieren