{"id":"providers/princeton-art-museum","relativePath":"providers/princeton-art-museum.md","title":"Princeton University Art Museum API Integration Plan","markdown":"# Princeton University Art Museum API Integration Plan\n\nStatus: Planned (B5 provider slice) \nUpdated: May 30, 2026\n\n## Official source\n\n- API base/docs: \n\n## Key platform facts (from official docs)\n\n- Base API host: `https://data.artmuseum.princeton.edu`\n- No authentication currently required (explicitly subject to change in future API versions).\n- Primary resources:\n - Objects\n - Makers\n - Packages\n - Search\n- All responses are JSON.\n- Static full dataset downloads are offered and refreshed weekly (recommended for non-dynamic bulk workflows).\n- Media payloads include IIIF 3-style URIs, e.g.:\n - `https://media.artmuseum.princeton.edu/iiif/3/collection/...`\n\n## Integration goals\n\n- Add Princeton as a first-class B5 provider through `provider-interface`.\n- Preserve rich object context (makers, texts, exhibitions, geography, terms, classifications, media) in `_source.raw` while mapping stable Linked Art boundary fields.\n- Preserve IIIF media/service references for downstream deep-zoom/manifest work.\n\n## Proposed implementation slice\n\n### Adapter\n\n- `src/adapters/princeton.ts`\n - profile descriptor\n - object fetch + search helpers\n - normalizer to `SourceRecord` + `Artwork` boundary DTO\n - IIIF media URL extraction helpers\n\n### Routes\n\n- `GET /api/princeton/profile`\n- `POST /api/princeton/search`\n- `POST /api/princeton/object`\n- `POST /api/princeton/import`\n\n### UI\n\n- add `princeton` source toggle in `/explore`\n- show source attribution + image/reuse status + media links in detail views\n\n## Env configuration\n\n- `PRINCETON_API_BASE` (default: `https://data.artmuseum.princeton.edu`)\n- `PRINCETON_API_AUTH_MODE` (default: `none`; supports future token/header mode without refactor)\n\n## Operational guardrails\n\n- Since static weekly exports are available, avoid naive high-frequency crawling for large-scale bulk ingest.\n- Keep route-layer pagination caps and timeouts to protect request budgets.\n- Preserve provenance and attribution data from Princeton payloads.\n\n## Standards mapping + tests\n\nRequired rounds (minimum): object/provenance/shared-structure + protocol/search rounds.\n\nRequired tests (failing-first):\n\n- `tests/adapters/princeton.test.ts`\n- `tests/api/princeton/profile.test.ts`\n- `tests/api/princeton/search.test.ts`\n- `tests/api/princeton/object.test.ts`\n- `tests/api/princeton/import.test.ts`\n\nProvider-specific conformance tests:\n\n- rich nested field passthrough safety (`texts`, `media`, `exhibitions`, `geography`, `terms`)\n- IIIF URI extraction and canonical media-link mapping\n- no-auth default mode + forward-compatible auth-mode branching\n\nProtocol checks (B8):\n\n- OPTIONS/CORS behavior on Princeton routes\n- response shape conformance\n- URI opacity + array-cardinality safety where applicable\n\n## Exit criteria\n\n- Adapter + routes + tests green.\n- `/explore` can search/import Princeton records.\n- PR includes Standards Mapping note with round + fixture anchor coverage.\n","sections":[{"level":2,"heading":"Official source","anchor":"official-source"},{"level":2,"heading":"Key platform facts (from official docs)","anchor":"key-platform-facts-from-official-docs"},{"level":2,"heading":"Integration goals","anchor":"integration-goals"},{"level":2,"heading":"Proposed implementation slice","anchor":"proposed-implementation-slice"},{"level":3,"heading":"Adapter","anchor":"adapter"},{"level":3,"heading":"Routes","anchor":"routes"},{"level":3,"heading":"UI","anchor":"ui"},{"level":2,"heading":"Env configuration","anchor":"env-configuration"},{"level":2,"heading":"Operational guardrails","anchor":"operational-guardrails"},{"level":2,"heading":"Standards mapping + tests","anchor":"standards-mapping-tests"},{"level":2,"heading":"Exit criteria","anchor":"exit-criteria"}],"html":"

Princeton University Art Museum API Integration Plan

\n

Status: Planned (B5 provider slice)

\n

Updated: May 30, 2026

\n

Official source

\n\n

Key platform facts (from official docs)

\n\n

Integration goals

\n\n

Proposed implementation slice

\n

Adapter

\n\n

Routes

\n\n

UI

\n\n

Env configuration

\n\n

Operational guardrails

\n\n

Standards mapping + tests

\n

Required rounds (minimum): object/provenance/shared-structure + protocol/search rounds.

\n

Required tests (failing-first):

\n\n

Provider-specific conformance tests:

\n\n

Protocol checks (B8):

\n\n

Exit criteria

\n","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"c8823f65ee414f7a7371c64da159c8489a26dc480d2f34658ca674589b3e8201","checksumPrefix":"c8823f65ee41","anchorCount":11,"lineCount":92,"rawUrl":"/api/docs/content?path=providers%2Fprinceton-art-museum.md","htmlUrl":"/docs?doc=providers%2Fprinceton-art-museum.md","apiUrl":"/api/docs/content?path=providers%2Fprinceton-art-museum.md"}