Skip to content

Conversation

@johnf
Copy link
Collaborator

@johnf johnf commented Oct 21, 2025

BREAKING CHANGE: File access endpoints have been restructured

Replace /entity/{id}/file/{fileId} with /file/{id} for direct file
access. Add /entity/{id}/crate endpoint to retrieve raw RO-Crate
JSON-LD metadata. Add /files endpoint for listing files with filtering
and pagination.

  • Add /file/{id} endpoint for direct file access
  • Add /entity/{id}/crate endpoint for RO-Crate metadata retrieval
  • Add /files endpoint for listing files with memberOf filtering
  • Add fileId field to MediaObject entities to link to file system
  • Extract Access schema for reuse across entities and files
  • Add File schema with file-specific metadata
  • Update documentation to clarify entities vs files distinction

This improves API clarity by distinguishing between RO-Crate entities
(Collections, Objects, MediaObjects) and the underlying file system.

@johnf johnf force-pushed the refactor-rocrate-file branch from 043c952 to e095afa Compare October 26, 2025 23:36
@johnf johnf changed the title feat!: add File entity support and RO-Crate metadata endpoint feat!: separate file access from entity endpoints and add RO-Crate metadata endpoint Oct 26, 2025
@johnf johnf force-pushed the refactor-rocrate-file branch 2 times, most recently from ad3e13c to 6e7dc62 Compare October 27, 2025 00:56
metadata endpoint

BREAKING CHANGE: File access endpoints have been restructured

Replace /entity/{id}/file/{fileId} with /file/{id} for direct file
access. Add /entity/{id}/rocrate endpoint to retrieve raw RO-Crate
JSON-LD metadata. Add /files endpoint for listing files with filtering
and pagination.

- Add /file/{id} endpoint for direct file access
- Add /entity/{id}/rocrate endpoint for RO-Crate metadata retrieval
- Add /files endpoint for listing files with memberOf filtering
- Add fileId field to MediaObject entities to link to file system
- Extract Access schema for reuse across entities and files
- Add File schema with file-specific metadata
- Update documentation to clarify entities vs files distinction

This improves API clarity by distinguishing between RO-Crate entities
(Collections, Objects, MediaObjects) and the underlying file system.
@johnf johnf force-pushed the refactor-rocrate-file branch from 6e7dc62 to 2ce371d Compare October 30, 2025 22:53
@johnf johnf merged commit e8645cd into main Oct 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants