https://github.com/friendsofredaxo/api
APIs für REDAXO
https://github.com/friendsofredaxo/api
api redaxo redaxo-addon redaxo-api redaxo5
Last synced: 4 months ago
JSON representation
APIs für REDAXO
- Host: GitHub
- URL: https://github.com/friendsofredaxo/api
- Owner: FriendsOfREDAXO
- License: mit
- Created: 2025-02-24T15:56:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-19T19:30:53.000Z (5 months ago)
- Last Synced: 2026-02-19T21:57:04.887Z (5 months ago)
- Topics: api, redaxo, redaxo-addon, redaxo-api, redaxo5
- Language: PHP
- Homepage:
- Size: 971 KB
- Stars: 17
- Watchers: 3
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# APIs für REDAXO
## Beschreibung
Dieses AddOn ermöglich es, APIs in REDAXO zu nutzen. Dabei geht es vor allem um die Nutzung von APIs aus anderen Systemen heraus, um z.B. Daten abzugleichen oder zu ergänzen. Weiterhin ist die API erweiterbar. Jedes andere AddOn kann eigene Endpunkte anlegen.
Zunächst ist geplant die Basisfeatures von REDAXO abzubilden.
## Geplante und umgesetzte Endpunkte
Wenn getestet, dann wurde explicit nochmal geprüft, ob die Funktionalität exakt so umgesetzt sind, wie sie in REDAXO/Core verwendet wurde.
* Passende Extension Points
* Vorhandene Klassen wurden genutzt
* Felder sind auf das Nötigste reduziert. Keine Felder von externen/anderen AddOns/PlugIns werden ausgegeben oder verarbeitet.
* OpenAPI Spezifikationen sind vorhanden und richtig verwendet
### Endpunkte
| Endpunkt | Method | Beschreibung | Status | Test | Backend | Backend Test |
|------------------------------------------------|-----------|---------------------------------|--------|------|---------| ------------ |
| /api/structure/articles | GET | Artikelliste | ✅ | ✅ | ✅ | ✅ |
| /api/structure/articles/{id}/slices | GET | Slices eines Artikel anzeigen | ✅ | | ✅ | |
| /api/structure/articles/{id}/slices | POST | ArticleSlice erstellen | ✅ | ✅ | ✅ | |
| /api/structure/articles/{id}/slices/{slice_id} | GET | Slice eines Artikel anzeigen | ✅ | | ✅ | |
| /api/structure/articles/{id}/slices/{slice_id} | PUT/PATCH | Slice eines Artikel ändern | ✅ | | ✅ | |
| /api/structure/articles | POST | Artikel anlegen | ✅ | ✅ | ✅ | ✅ |
| /api/structure/articles/{id} | GET | Artikel anzeigen | ✅ | | ✅ | ✅ |
| /api/structure/articles/{id} | DELETE | Artikel löschen | ✅ | ✅ | ✅ | ✅ |
| /api/structure/articles/{id} | PUT/PATCH | Artikel ändern | ✅ | | ✅ | |
| /api/structure/categories | POST | Kategorie anlegen | ✅ | ✅ | ✅ | |
| /api/structure/categories/{id} | DELETE | Kategorie löschen | ✅ | ✅ | ✅ | |
| /api/structure/categories/{id} | PUT/PATCH | Kategorie ändern | ✅ | | ✅ | |
| /api/media | GET | Medienliste | ✅ | ✅ | ✅ | ✅ |
| /api/media/{filename} | GET | Mediametadaten | ✅ | ✅ | ✅ | |
| /api/media/{filename}/file | GET | Mediafile (raw) | ✅ | ✅ | ✅ | |
| /api/media | POST | Medium anlegen | ✅ | | ✅ | |
| /api/media/{filename} | DELETE | Medium löschen | ✅ | ✅ | ✅ | |
| /api/media/{filename} | PUT/PATCH | Medium ändern | ✅ | | ✅ | |
| /api/media/categories | GET | Mediakategorienliste | ✅ | ✅ | ✅ | ✅ |
| /api/media/categories | POST | Mediakategorie anlegen | ✅ | | ✅ | |
| /api/media/categories/{id} | DELETE | Mediakategorie löschen | ✅ | | ✅ | |
| /api/media/categories/{id} | PUT/PATCH | Mediakategorie ändern | ✅ | | ✅ | |
| /api/modules | GET | Modulliste | ✅ | ✅ | ✅ | ✅ |
| /api/modules | POST | Modul anlegen | ✅ | ✅ | ✅ | ✅ |
| /api/module/{id} | GET | Modul auslesen | ✅ | ✅ | ✅ | ✅ |
| /api/module/{id} | DELETE | Modul löschen | ✅ | ✅ | ✅ | ✅ |
| /api/module/{id} | PUT/PATCH | Modul ändern | ✅ | ✅ | ✅ | ✅ |
| /api/templates | GET | Template Liste | ✅ | ✅ | ✅ | ✅ |
| /api/templates | POST | Template anlegen | ✅ | ✅ | ✅ | ✅ |
| /api/templates/{id} | DELETE | Template löschen | ✅ | ✅ | ✅ | ✅ |
| /api/templates/{id} | PUT/PATCH | Template ändern | ✅ | ✅ | ✅ | ✅ |
| /api/users | GET | Userliste | ✅ | ✅ | ✅ | ✅ |
| /api/users | POST | User anlegen | ✅ | | ✅ | ✅ |
| /api/users/{id} | GET | User holen | ✅ | ✅ | ✅ | ✅ |
| /api/users/{id}/role | GET | Userrolen eines Users auflisten | ❌ | | | |
| /api/users/{id}/role | POST | Userrole einem Users hinzufügen | ❌ | | | |
| /api/users/{id}/role | DELETE | Userrole eines Users löschen | ❌ | | | |
| /api/users/{id} | DELETE | User löschen | ✅ | ✅ | ✅ | ✅ |
| /api/users/{id} | PUT/PATCH | User ändern | ✅ | | ✅ | |
| /api/users/roles | GET | Rollenliste | ✅ | ✅ | ✅ | ✅ |
| /api/users/roles | POST | Rolle anlegen | ❌ | | | |
| /api/users/roles/{id} | DELETE | Rolle löschen | ❌ | | | |
| /api/users/roles/{id} | PUT/PATCH | Rolle ändern | ❌ | | | |
| /api/system/clangs | GET | Sprachenliste | ✅ | ✅ | ✅ | ✅ |
| /api/system/clangs | POST | Sprache anlegen | ✅ | ✅ | ✅ | ✅ |
| /api/system/clangs/{id} | GET | Sprache auslesen | ✅ | ✅ | ✅ | ✅ |
| /api/system/clangs/{id} | DELETE | Sprache löschen | ✅ | ✅ | ✅ | ✅ |
| /api/system/clangs/{id} | PUT/PATCH | Sprache ändern | ✅ | ✅ | ✅ | ✅ |
## Bei Problemen mit Authorization
Es kann sein, dass Apache nicht alle Header weitergibt. In diesem Fall kann es helfen, die folgenden Zeilen in die .htaccess zu schreiben:
```
# Sets the HTTP_AUTHORIZATION header removed by Apache
RewriteCond %{HTTP:Authorization} .
RewriteRule ^ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
```
## Authentifizierung beachten
Die meisten APIs haben Authentifizierung. Das heisst, es muss ein API-Token im Backend angelegt werden, um die Endpunkte nutzen zu können, wie auch der entsprechende Scope gesetzt werden.
Andere APIs haben eine Backend-Authentifizierung, die dann über den Backend-User läuft, d.h. es kann der Session Cookie verwendet werden, um die Endpunkte zu nutzen.
## API Struktur
Am besten direkt im AddOn unter OpenAPI nachsehen. Dort werden alle verfügbaren Endpunkte aufgelistet.
## Was funktioniert vielleicht nicht, und müssen AddOn Entwickler beachten
Das API AddON funktioniert aus dem Frontend-User-Kontext heraus. Das heisst, sollte es registrierte Methoden an bestimmten
ExtensionPoints geben, welche nur im Backend-User-Kontext gesetzt wurden, z.B. (rex::isBackend) -> registerEP, dann werden diese nicht in der dieser API ausgeführt.
D.h. diese AddOns müssen entsprechend angepasst werden.
## Weitere noch nicht beachtete Usecases
### FE API (Wird hier noch nicht behandelt)
- GET API
- für Content frei und abhängig vom Frontenduserrechten YCom/YGroup
- POST/UPDATE/GET/DELETE API
- YCOm Profile, Password etc.
- für YForm
- Für Sonsiges
### Backend API
Authentifizierung läuft über den PHP Session Cookie, d.h. es muss ein Backend-User angemeldet sein, um die Endpunkte nutzen zu können. Diese Endpunkte beachten die Rechte des einzelnen Users und ist dafür gedacht, dass man diese nur aus dem Backend heraus aufrufen kann. Z.B. wenn man eine alternative Anzeige oder Verwaltung nutzen oder aufbauen möchte.
## Credits:
checked by: https://www.coderabbit.ai