Id-basierte Filter

1. 🆔 ID-basierte Filter

Filtern nach bestimmten UUIDs von Objekten, z. B. Inhalten, Endpunkten oder Erstellern.

ContentID

Dieser Filter ermöglicht es Ihnen, Inhalte direkt über ihre eindeutige Inhalts-ID (UUID) zu finden oder auszuschließen. Sie können entweder eine Liste spezifischer IDs angeben, die enthalten sein sollen (in), oder eine Liste von IDs, die ausgeschlossen werden sollen (notIn). Dies ist ideal, wenn Sie den genauen Identifikator des gewünschten Inhalts kennen.

📋 Code

endpointId

Hier brauchen Sie keinen Filter angeben da dieser schon in der Url angegeben wird nach endpoint/ kommt der Endpoint

📋 Code

watchListId

Verwenden Sie diesen Filter, um Inhalte zu finden, die auf einer bestimmten Watchlist (UUID) vermerkt sind, oder um Inhalte auszuschließen, die zu einer Watchlist gehören. Dies ist nützlich für personalisierte Empfehlungen, Überwachungslisten oder das Management von Inhalten, die bestimmte Kriterien erfüllen.

📋 Code

classificationTreeId

Eine Option, um die über den Datenendpunkt vordefinierte Filterung weiter zu verfeinern, ist durch das Einschränken der Inhalte auf Basis von Klassifizierungen. Sie können dabei sowohl als notwendiges als auch als ausschließendes Kriterium verwendet werden.

Wird die Klassifizierung als notwendiges Kriterium übergeben, werden nur Inhalte ausgeliefert, die mit einer bestimmten Klassifizierung wie z.B. Inhaltstypen > Ort > Öffentliche Einrichtung > Museum verknüpft sind. Im Fall einer ausschließenden Verwendung werden eben diese Inhalte ausgeschlossen.

Außerdem kann festgelegt werden ob Sub-Klassifizierungen bei der Filterung berücksichtigt werden sollen oder nicht. Im Detail ergeben sich damit die folgenden Kombinationsmöglichkeiten:

1. filter[classifications][in][withoutSubtree][]: Inhalte müssen mit einer der übergebenen Klassifizierungen verknüpft sein. Eine indirekte Verknüpfung über eine Sub-Klassifizierung wird bei dieser Art der Abfrage nicht berücksichtigt. (Sehr wohl berücksichtigt werden aber indirekte Verknüpfungen, die sich aufgrund eines Klassifizierungs-Mappings ergeben.)

2. filter[classifications][notIn][withSubtree][]: Inhalte dürfen nicht mit einer der übergebenen Klassifizierungen oder einer zugehörigen Sub-Klassifizierung verknüpft sein.

3. filter[classifications][notIn][withoutSubtree][]: Inhalte dürfen nicht mit einer der übergebenen Klassifizierungen verknüpft sein. Eine indirekte Verknüpfung über eine Sub-Klassifizierung wird bei dieser Art der Abfrage nicht berücksichtigt. (Sehr wohl berücksichtigt werden aber indirekte Verknüpfungen, die sich aufgrund eines Klassifizierungs-Mappings ergeben.)

📋 Code