{"id":"providers/museumsvictoria-collections-api","relativePath":"providers/museumsvictoria-collections-api.md","title":"Museums Victoria Collections API Integration","markdown":"# Museums Victoria Collections API Integration\n\nStatus: Implemented (items-first provider slice)\nUpdated: July 4, 2026\n\n## Official Source\n\n- Developer docs: \n- API base: \n\n## Key Platform Facts\n\n- The API is a GET-only JSON service.\n- Requests should include a `User-Agent` header.\n- Search/list endpoints support `page`, `perpage`, and `envelope=true`.\n- Default list size is 40 records; maximum `perpage` is 100.\n- Pagination appears in response headers and, with `envelope=true`, in the JSON body.\n- Search supports facets such as `recordtype`, `hasimages`, `imagelicence`, `category`, `collectingarea`, and `culturalgroup`.\n\n## Implemented Slice\n\nThe current Meta Museum provider slice is intentionally item-first:\n\n- `recordtype=item`\n- `hasimages=yes` for discovery search\n- bounded import/search pages capped at 100 records\n- articles, species, and specimen endpoints excluded until they receive dedicated semantic mapping\n\n## Adapter And Routes\n\n- Adapter: `src/adapters/museumsvictoria.ts`\n- Direct routes:\n - `GET /api/museumsvictoria/profile`\n - `POST /api/museumsvictoria/search`\n - `POST /api/museumsvictoria/object`\n - `POST /api/museumsvictoria/import`\n- Facade routes:\n - `GET /api/providers/museumsvictoria/profile`\n - `POST /api/providers/museumsvictoria/search`\n - `POST /api/providers/museumsvictoria/import`\n\n## Mapping Notes\n\n- Item records are normalized through the shared expansion-provider boundary, then annotated with Museums Victoria source constraints.\n- `displayTitle`, object summary, physical description, significance, associations, keywords, and media are preserved in source snapshots.\n- Media URLs are projected into `representation` entries with media-level licence and rights-statement context.\n- First Peoples and cultural-context fields are carried as review-sensitive source notes rather than flattened into generic claims.\n\n## Operational Guardrails\n\n- Preserve item and media-level rights before any publication workflow.\n- Keep imports bounded to one official API page.\n- Use the official item API URL as the stable source URL when an item identifier is available.\n- Treat articles, species, and specimens as future provider slices, not implicit artwork records.\n\n## Test Coverage\n\n- `tests/adapters/museumsvictoria.test.ts`\n- `tests/api/museumsvictoria/search.test.ts`\n- `tests/api/museumsvictoria/object.test.ts`\n- `tests/api/providers/expansion-routes.test.ts`\n- `tests/fixtures/validation/providers/museumsvictoria/pass.json`\n- `tests/fixtures/validation/providers/museumsvictoria/fail.json`\n","sections":[{"level":2,"heading":"Official Source","anchor":"official-source"},{"level":2,"heading":"Key Platform Facts","anchor":"key-platform-facts"},{"level":2,"heading":"Implemented Slice","anchor":"implemented-slice"},{"level":2,"heading":"Adapter And Routes","anchor":"adapter-and-routes"},{"level":2,"heading":"Mapping Notes","anchor":"mapping-notes"},{"level":2,"heading":"Operational Guardrails","anchor":"operational-guardrails"},{"level":2,"heading":"Test Coverage","anchor":"test-coverage"}],"html":"

Museums Victoria Collections API Integration

\n

Status: Implemented (items-first provider slice)

\n

Updated: July 4, 2026

\n

Official Source

\n\n

Key Platform Facts

\n\n

Implemented Slice

\n

The current Meta Museum provider slice is intentionally item-first:

\n\n

Adapter And Routes

\n\n

Mapping Notes

\n\n

Operational Guardrails

\n\n

Test Coverage

\n","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"a5408e229cdc97f6e430172058b1e658920afa45491122d07178f7135fb6a7bf","checksumPrefix":"a5408e229cdc","anchorCount":7,"lineCount":64,"rawUrl":"/api/docs/content?path=providers%2Fmuseumsvictoria-collections-api.md","htmlUrl":"/docs?doc=providers%2Fmuseumsvictoria-collections-api.md","apiUrl":"/api/docs/content?path=providers%2Fmuseumsvictoria-collections-api.md"}