这一合作伙伴关系是在 Horizon 2020 Fet 旗舰呼叫计划资助的时间机器项目完成后建立的。
 |
欧洲数字文化遗产-europeana
专用API
【更新时间: 2024.07.08】
欧洲数字文化遗产是一套用于访问Europeana平台上丰富的数字文化遗产内容的编程接口。Europeana是一个欧洲数字图书馆、博物馆和档案馆的门户，提供超过5800万个数字化项目的访问。这些项目包括图书、音乐、艺...
咨询
去服务商官网采购>
|
服务星级：2星
调用次数
0
次
集成人数
0
人
商用人数
0
人
SLA: N/A
响应: N/A
适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
|
相似API
- API详情
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是europeana的欧洲数字文化遗产?
欧洲数字文化遗产是一套用于访问Europeana平台上丰富的数字文化遗产内容的编程接口。Europeana是一个欧洲数字图书馆、博物馆和档案馆的门户，提供超过5800万个数字化项目的访问。这些项目包括图书、音乐、艺术品、视频、照片和博物馆文物等。
什么是europeana的欧洲数字文化遗产？
由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用europeana的欧洲数字文化遗产，从而实现程序的自动化交互，提高服务效率。
europeana的欧洲数字文化遗产有哪些核心功能？
 |
 |
 |
访问 API了解获得 API 密钥后如何访问我们的每个 API。 |
搜索接口该API 提供了一种在Europeana 存储库上搜索元数据记录和媒体的方法。 |
记录API该 API 将记录 ID 作为输入，并返回在 EDM 中建模的所有元数据和对象信息。 |
 |
 |
 |
实体API此 API 允许您从 Eurona 的实体集合中检索和搜索 LOD 实体，包括人物、地点等…… |
注释API注释 API 允许您创建和检索用户和机器在 Eurona 对象或媒体上创建的注释。 |
IIIF API这些 API 提供了另一种方法来分组、搜索和访问有关文化遗产图像的信息。 |
 |
 |
 |
SPARQL此 API 允许您探索 Eurona 数据与外部数据源（例如 Geonames、Wikidata 等）之间的连接。 |
关联开放数据了解 Europea API 套件支持哪些不同的链接开放数据格式。 |
数据集下载和OAI-PMH我们提供从 Europea.eu 下载和收集元数据的方法，这些方法更适合规模化。 |
 |
 |
 |
缩略图API使用此 API 可以搜索、检索和使用为 Europea 数据库中摄取的对象自动生成的缩略图。 |
推荐API此 API 允许您与我们的推荐系统进行交互，该系统会向用户推荐其他类似或相关的记录。 |
用户设置API通过此 API，可以访问 Eurona.eu 上与用户生成的画廊相关的所有数据。 |
europeana的欧洲数字文化遗产的核心优势是什么？
-
丰富的内容资源：
- Europeana提供超过5800万个数字化项目，包括图书、音乐、艺术品、视频、照片和博物馆文物，覆盖广泛的历史时期和文化领域。
-
多样的媒体类型：
- API支持多种媒体类型，如图像、文本、音频和视频，满足不同应用场景的需求。
-
高质量的数据：
- Europeana与欧洲各地的图书馆、博物馆和档案馆合作，确保数据的高质量和权威性。
-
跨语言支持：
- Europeana平台支持多种欧洲语言，使其内容能够触及更广泛的受众。
-
开放访问与使用：
- API采用开放访问策略，开发者可以免费使用这些数据来开发各种应用，促进文化传播和共享。
-
强大的搜索功能：
- API提供精确的搜索和过滤功能，帮助用户快速找到所需的数字资源。
-
实时数据更新：
- 数据库内容定期更新，确保用户能够访问最新的文化资源。
-
丰富的元数据：
- 提供详细的元数据，包括项目的来源、作者、日期和描述，增强了资源的可用性和研究价值。
-
兼容性与易集成：
- API设计简洁，易于与各种平台和应用集成，支持标准化的数据格式如JSON和XML。
-
开发者支持与文档：
- 提供详细的API文档和开发者支持，使开发过程更加顺畅。
在哪些场景会用到europeana的欧洲数字文化遗产？
 |
1. 学术研究平台：
|
 |
2. 教育应用：
|
 |
3. 文化导览应用：
|
 |
4. 多媒体创意项目：
|
 |
5. 在线博物馆展览：
|
使用指南
登记
要开始使用Europeana API，您需要在注册页面注册一个密钥。注册后，您将获得个人私有和公共身份验证密钥。私钥用于需要额外用户身份验证的特定方法，而公钥必须由所有其他API方法使用，请参阅使用API密钥进行访问。
我们使用这些密钥来匿名收集有关API使用情况的相关统计数据，以便我们更好地改进它。请不要与第三方共享这些密钥，也不要在用户界面或标记中暴露这些密钥，因为API密钥是保密的，仅供客户端或用户使用。
Europeana APIs
除了少数例外（即Thumbnail API和OAI-PMH），在访问Europeana API时，您需要提供访问密钥（对应于您的公钥）或令牌（由Auth Service颁发）作为请求的一部分。
使用API密钥（只读访问）
如果您只想访问公共信息，那么提供访问密钥就足够了，但是，如果您需要访问私有信息或向API贡献数据，那么令牌是强制性的。提供访问密钥的首选选项是使用“x-api-key”头，但也可以使用其他选项。
“X-Api-Key”标题（首选）
此选项使用标准的“X-Api-Key”头来提供密钥。此选项是首选选项，因为它被广泛采用，并且因为它是在请求中共享密钥的更安全的方式。
GET https://api.europeana.eu/...
X-Api-Key: [WSKEY]“wskey”参数
此选项使用wskey参数而不是头。该选项是2023年之前的首选和唯一选项，但计划在未来几年内弃用。
GET https://api.europeana.eu/...?wskey=[WSKEY]使用访问承载令牌
此选项提供使用访问令牌的访问权限，这些令牌由Auth Service作为Authorization标头中的承载令牌颁发。这是访问Europeana API的首选和最有效的方式，但是，目前仅限于选择性数量的API客户。
GET https://api.europeana.eu/...
Authorization: Bearer [JWT_TOKEN]
产品问答
?
我可以将从 Europeana 的 API 获得的数据用于我自己的项目吗？来自 Europeana ...
Europeana API 中的所有元数据均以CC0形式提供，这意味着您可以随意重复使用这些元数据，而不受任何限制。其中一些元数据可能链接到 Europeana 合作伙伴的内容，例如 edm:IsShownBy 和 edm:Object 字段中链接的内容。这些对象可根据 europeana:rights/edm:rights 字段中对象元数据中提及的权利声明使用。在使用 Europeana 元数据中链接的对象之前，请务必检查这些字段！
?
如何解决同源策略/CORS 问题？
由于同源策略，在 Web 浏览器上运行的客户端应用程序通常被禁止调用在其自身域之外提供服务的端点的方法。为了绕过此限制，我们为我们提供的所有 API支持CORS 。对于记录 API 和搜索 API 等 API，我们仍然提供对过时的JSONP机制的支持。鉴于此机制已被 CORS 取代，我们可能会在这些 API 的未来版本中停止支持它，因此我们强烈建议所有用户从 JSONP 转向 CORS。
?
我可以使用 API 将我拥有的任何文化遗产数据添加到 Europeana 的数据库中吗？
Europeana 的大多数 API 都是只读的。它们旨在让您从我们的数据库中搜索、查找、下载和重复使用数字文化遗产数据。但是，有多种方法可以丰富我们的元数据并将信息发送到我们的 API。当从我们的 API 请求信息时，您几乎总是执行 GET 请求。当向我们的 API 发送新信息时，您很可能使用 POST 或 PUT 请求来发送。
?
Europeana 使用什么元数据格式来构建其数据？
Europeana 的元数据采用 Europeana 数据模型（简称 EDM）构建。我们从全欧洲的合作机构收到的元数据都采用不同的标准和最佳实践以不同的方式格式化。我们将所有这些信息映射到 EDM，以便为欧洲所有数字文化遗产提供一个标准元数据模型。
?
使用 API 有任何限制吗？我多久可以进行一次查询？
Europeana 允许免费访问其所有 API。所有从我们的数据库读取信息的 API 方法始终免费使用，并且绝不会受到任何限制。这意味着您可以免费使用 Europeana 的 API 构建平台、产品、应用程序、服务和项目，并根据需要进行扩展。您可以随时查询我们的 API，而不会受到任何限制。如果您要进行大量 API 调用，我们要求您礼貌地进行 API 调用，在调用之间留出一些时间。在每个请求之间留出至少几毫秒的时间将使我们的服务器更容易处理负载。
?
是否有任何客户端库或包，以便我可以更轻松地使用不同编程语言的 Europeana API？
是的！Europeana 的 API 的大多数客户端库和软件包都是由外部用户制作的，并未由 Europeana 维护或验证。
?
如何下载有关单个对象的所有信息？
要检索数据库中有关单个 Europeana 项目（又称记录）的所有信息，请使用记录 API。您需要要从中检索信息的项目的数据集和记录 ID。您可以在正在查看的 europeana 项目的 URL 中找到这些标识符，格式如下：/datasetID/recordID。然后将此信息添加到基本 URL https://api.europeana.eu/record/v2/并在 wskey 字段中添加您的 API 密钥。
?
如何检索单个机构中的所有项目？
要查找与单个元数据字段中的术语相对应的所有项目，请使用搜索 API。要找出存在哪些搜索字段，请参阅搜索 API 文档中的“搜索字段”一章。要使用搜索字段，请将该搜索字段添加到“查询”参数或“qf”参数。要检索单个机构的所有项目，请在“DATA_PROVIDER”字段中输入该机构的名称。
?
我如何找到公开许可的物品？
要在 Europeana 上搜索公开许可的物品，请使用搜索 API。 填写必填字段：wskey 填写您的 API 密钥，query 填写您要搜索的内容。然后添加可重用性参数并将其设置为开放。这会将您的搜索限制为仅公开许可的内容。您可以在此表中查看哪些版权许可证与哪个参数相对应。当您将可重用性字段设置为“开放”时，API 将仅返回具有公共领域标记、CC0、CC BY 或 CC BY-SA 版权许可证的项目。
?
我的 API 查询仅返回一定数量的结果。如何查看和下载符合我的查询的所有结果？
几乎所有的 Europeana API 都有一个 rows 参数，该参数决定了您的 API 响应中将获得多少行结果。当您未指定任何内容时，此 row 参数将具有默认值。对于搜索 API，默认的 row 参数值为 12。即使您的查询获得了数千个结果，搜索 API 默认也只返回前 12 个结果。您可以使用查询中的 rows 字段更改 rows 参数值。rows 参数通常具有最大值。对于搜索 API，最大值为 100。要获取查询响应中的前 100 个结果，请设置 rows=100。如果您想查看接下来的 100 个结果，可以使用 start 参数。此参数决定要跳过多少个搜索结果。如果您的请求响应中有 200 个项目，则使用 rows=100 将允许您查看前 100 个项目。要查看接下来的 100 个项目，请将开始设置为 101，将行设置为 100。这将跳过前 100 个结果并显示接下来的 100 个结果，从结果编号 101 到结果编号 200。
?
我收到错误“无法对前 1000 个搜索结果以外的内容进行分页。请使用基于光标的分页”。我该如何修复此...
要从 Search API 获取前 1000 条以外的结果，您需要使用基于游标的分页。要启动基于游标的分页，请将 cursor=* 添加到您的查询 URL。要转到下一页结果，请从响应中获取 nextCursor 值并将其传递给 cursor 参数以分页到下一页（您需要对键进行 urlscape）。
关于我们
europeana
企业
我们分享和推广欧洲的数字文化遗产，让每个人都能用于学习、工作或娱乐。
Europeana 网站为文化遗产爱好者、专业人士、教师和研究人员提供访问欧洲数字文化遗产的渠道。为什么？为了激发和传播关于我们的历史和文化的新观点和开放对话。分享和享受我们丰富的文化遗产。用它来创造新事物。
我们为您提供来自欧洲各地提供机构的数百万件物品。探索有关艺术、报纸、考古、时尚、科学、体育等的艺术品、书籍、音乐和视频。
联系信息
服务时间：
00:00-24:00
电话号码：
+31(0)703 140 991
邮箱：
info@europeana.eu
我们喜欢看到您以创造性的方式使用在这里找到的内容，无论是教师开发课程资源，开发人员使用我们的开源 API 制作游戏，还是文化爱好者创建 gif 和讲述故事。
我们依靠数以千计的欧洲提供机构，如画廊、图书馆、档案馆和博物馆，它们与我们有共同的信念，即获取文化遗产具有变革性——它赋予人们力量并造福整个社会。
感谢他们致力于将藏品放到网上并愿意分享，我们可以向每个人提供这个庞大而多样的值得信赖的欧洲数字文化遗产收藏。
我们展示来自 2000 多家不同的欧洲提供机构的数字文化遗产 - 但我们不会与每家机构单独合作。相反，聚合器网络会收集他们的项目及其相关数据，对其进行彻底检查，并使用地理位置等信息对其进行丰富，或通过相关人员、地点或主题将其链接到其他材料或数据集。
时间机器组织 |
ViMMPlus这一合作伙伴关系旨在将欧洲和世界各地从事数字文化遗产工作的领先公共和私营部门组织聚集在一起。 |
欧洲中国此次合作旨在通过文化资源的数字化，促进中国-亚洲-欧洲文化遗产的数字化保存。 |
权利声明联盟权利声明联盟通过权利声明促进在线文化遗产的参与。 |
教育合作伙伴
欧洲学校网这一合作伙伴关系成立于 2016 年，旨在帮助将文化的使用纳入课堂、跨课程和跨国层面的主流。 |
欧洲克利奥此次合作的重点是在 Historana 上发布包含 Eurona 内容的数字学习资源，并提高欧洲历史教师对使用 Eurona 作为教育资源的认识。 |
研究合作伙伴
CLARIN这一合作关系于 2015 年建立，CLARIN 将来自欧洲的数字文化遗产数据整合到其研究基础设施中，供学术界使用。 |
DARIAHEuropea 和 DARIAH 致力于改善文化机构数字馆藏的获取条件，并支持学术界将数字文化遗产重新用于研究目的。 |
API接口列表
使用指南
登记
要开始使用Europeana API，您需要在注册页面注册一个密钥。注册后，您将获得个人私有和公共身份验证密钥。私钥用于需要额外用户身份验证的特定方法，而公钥必须由所有其他API方法使用，请参阅使用API密钥进行访问。
我们使用这些密钥来匿名收集有关API使用情况的相关统计数据，以便我们更好地改进它。请不要与第三方共享这些密钥，也不要在用户界面或标记中暴露这些密钥，因为API密钥是保密的，仅供客户端或用户使用。
Europeana APIs
除了少数例外（即Thumbnail API和OAI-PMH），在访问Europeana API时，您需要提供访问密钥（对应于您的公钥）或令牌（由Auth Service颁发）作为请求的一部分。
使用API密钥（只读访问）
如果您只想访问公共信息，那么提供访问密钥就足够了，但是，如果您需要访问私有信息或向API贡献数据，那么令牌是强制性的。提供访问密钥的首选选项是使用“x-api-key”头，但也可以使用其他选项。
“X-Api-Key”标题（首选）
此选项使用标准的“X-Api-Key”头来提供密钥。此选项是首选选项，因为它被广泛采用，并且因为它是在请求中共享密钥的更安全的方式。
GET https://api.europeana.eu/...
X-Api-Key: [WSKEY]“wskey”参数
此选项使用wskey参数而不是头。该选项是2023年之前的首选和唯一选项，但计划在未来几年内弃用。
GET https://api.europeana.eu/...?wskey=[WSKEY]使用访问承载令牌
此选项提供使用访问令牌的访问权限，这些令牌由Auth Service作为Authorization标头中的承载令牌颁发。这是访问Europeana API的首选和最有效的方式，但是，目前仅限于选择性数量的API客户。
GET https://api.europeana.eu/...
Authorization: Bearer [JWT_TOKEN]
依赖服务
产品问答
?
我可以将从 Europeana 的 API 获得的数据用于我自己的项目吗？来自 Europeana ...
Europeana API 中的所有元数据均以CC0形式提供，这意味着您可以随意重复使用这些元数据，而不受任何限制。其中一些元数据可能链接到 Europeana 合作伙伴的内容，例如 edm:IsShownBy 和 edm:Object 字段中链接的内容。这些对象可根据 europeana:rights/edm:rights 字段中对象元数据中提及的权利声明使用。在使用 Europeana 元数据中链接的对象之前，请务必检查这些字段！
?
如何解决同源策略/CORS 问题？
由于同源策略，在 Web 浏览器上运行的客户端应用程序通常被禁止调用在其自身域之外提供服务的端点的方法。为了绕过此限制，我们为我们提供的所有 API支持CORS 。对于记录 API 和搜索 API 等 API，我们仍然提供对过时的JSONP机制的支持。鉴于此机制已被 CORS 取代，我们可能会在这些 API 的未来版本中停止支持它，因此我们强烈建议所有用户从 JSONP 转向 CORS。
?
我可以使用 API 将我拥有的任何文化遗产数据添加到 Europeana 的数据库中吗？
Europeana 的大多数 API 都是只读的。它们旨在让您从我们的数据库中搜索、查找、下载和重复使用数字文化遗产数据。但是，有多种方法可以丰富我们的元数据并将信息发送到我们的 API。当从我们的 API 请求信息时，您几乎总是执行 GET 请求。当向我们的 API 发送新信息时，您很可能使用 POST 或 PUT 请求来发送。
?
Europeana 使用什么元数据格式来构建其数据？
Europeana 的元数据采用 Europeana 数据模型（简称 EDM）构建。我们从全欧洲的合作机构收到的元数据都采用不同的标准和最佳实践以不同的方式格式化。我们将所有这些信息映射到 EDM，以便为欧洲所有数字文化遗产提供一个标准元数据模型。
?
使用 API 有任何限制吗？我多久可以进行一次查询？
Europeana 允许免费访问其所有 API。所有从我们的数据库读取信息的 API 方法始终免费使用，并且绝不会受到任何限制。这意味着您可以免费使用 Europeana 的 API 构建平台、产品、应用程序、服务和项目，并根据需要进行扩展。您可以随时查询我们的 API，而不会受到任何限制。如果您要进行大量 API 调用，我们要求您礼貌地进行 API 调用，在调用之间留出一些时间。在每个请求之间留出至少几毫秒的时间将使我们的服务器更容易处理负载。
?
是否有任何客户端库或包，以便我可以更轻松地使用不同编程语言的 Europeana API？
是的！Europeana 的 API 的大多数客户端库和软件包都是由外部用户制作的，并未由 Europeana 维护或验证。
?
如何下载有关单个对象的所有信息？
要检索数据库中有关单个 Europeana 项目（又称记录）的所有信息，请使用记录 API。您需要要从中检索信息的项目的数据集和记录 ID。您可以在正在查看的 europeana 项目的 URL 中找到这些标识符，格式如下：/datasetID/recordID。然后将此信息添加到基本 URL https://api.europeana.eu/record/v2/并在 wskey 字段中添加您的 API 密钥。
?
如何检索单个机构中的所有项目？
要查找与单个元数据字段中的术语相对应的所有项目，请使用搜索 API。要找出存在哪些搜索字段，请参阅搜索 API 文档中的“搜索字段”一章。要使用搜索字段，请将该搜索字段添加到“查询”参数或“qf”参数。要检索单个机构的所有项目，请在“DATA_PROVIDER”字段中输入该机构的名称。
?
我如何找到公开许可的物品？
要在 Europeana 上搜索公开许可的物品，请使用搜索 API。 填写必填字段：wskey 填写您的 API 密钥，query 填写您要搜索的内容。然后添加可重用性参数并将其设置为开放。这会将您的搜索限制为仅公开许可的内容。您可以在此表中查看哪些版权许可证与哪个参数相对应。当您将可重用性字段设置为“开放”时，API 将仅返回具有公共领域标记、CC0、CC BY 或 CC BY-SA 版权许可证的项目。
?
我的 API 查询仅返回一定数量的结果。如何查看和下载符合我的查询的所有结果？
几乎所有的 Europeana API 都有一个 rows 参数，该参数决定了您的 API 响应中将获得多少行结果。当您未指定任何内容时，此 row 参数将具有默认值。对于搜索 API，默认的 row 参数值为 12。即使您的查询获得了数千个结果，搜索 API 默认也只返回前 12 个结果。您可以使用查询中的 rows 字段更改 rows 参数值。rows 参数通常具有最大值。对于搜索 API，最大值为 100。要获取查询响应中的前 100 个结果，请设置 rows=100。如果您想查看接下来的 100 个结果，可以使用 start 参数。此参数决定要跳过多少个搜索结果。如果您的请求响应中有 200 个项目，则使用 rows=100 将允许您查看前 100 个项目。要查看接下来的 100 个项目，请将开始设置为 101，将行设置为 100。这将跳过前 100 个结果并显示接下来的 100 个结果，从结果编号 101 到结果编号 200。
?
我收到错误“无法对前 1000 个搜索结果以外的内容进行分页。请使用基于光标的分页”。我该如何修复此...
要从 Search API 获取前 1000 条以外的结果，您需要使用基于游标的分页。要启动基于游标的分页，请将 cursor=* 添加到您的查询 URL。要转到下一页结果，请从响应中获取 nextCursor 值并将其传递给 cursor 参数以分页到下一页（您需要对键进行 urlscape）。
关于我们
europeana
企业
我们分享和推广欧洲的数字文化遗产，让每个人都能用于学习、工作或娱乐。
Europeana 网站为文化遗产爱好者、专业人士、教师和研究人员提供访问欧洲数字文化遗产的渠道。为什么？为了激发和传播关于我们的历史和文化的新观点和开放对话。分享和享受我们丰富的文化遗产。用它来创造新事物。
我们为您提供来自欧洲各地提供机构的数百万件物品。探索有关艺术、报纸、考古、时尚、科学、体育等的艺术品、书籍、音乐和视频。
联系信息
服务时间：
00:00-24:00
电话号码：
+31(0)703 140 991
邮箱：
info@europeana.eu
我们喜欢看到您以创造性的方式使用在这里找到的内容，无论是教师开发课程资源，开发人员使用我们的开源 API 制作游戏，还是文化爱好者创建 gif 和讲述故事。
我们依靠数以千计的欧洲提供机构，如画廊、图书馆、档案馆和博物馆，它们与我们有共同的信念，即获取文化遗产具有变革性——它赋予人们力量并造福整个社会。
感谢他们致力于将藏品放到网上并愿意分享，我们可以向每个人提供这个庞大而多样的值得信赖的欧洲数字文化遗产收藏。
我们展示来自 2000 多家不同的欧洲提供机构的数字文化遗产 - 但我们不会与每家机构单独合作。相反，聚合器网络会收集他们的项目及其相关数据，对其进行彻底检查，并使用地理位置等信息对其进行丰富，或通过相关人员、地点或主题将其链接到其他材料或数据集。
时间机器组织这一合作伙伴关系是在 Horizon 2020 Fet 旗舰呼叫计划资助的时间机器项目完成后建立的。 |
ViMMPlus这一合作伙伴关系旨在将欧洲和世界各地从事数字文化遗产工作的领先公共和私营部门组织聚集在一起。 |
欧洲中国此次合作旨在通过文化资源的数字化，促进中国-亚洲-欧洲文化遗产的数字化保存。 |
权利声明联盟权利声明联盟通过权利声明促进在线文化遗产的参与。 |
教育合作伙伴
欧洲学校网这一合作伙伴关系成立于 2016 年，旨在帮助将文化的使用纳入课堂、跨课程和跨国层面的主流。 |
欧洲克利奥此次合作的重点是在 Historana 上发布包含 Eurona 内容的数字学习资源，并提高欧洲历史教师对使用 Eurona 作为教育资源的认识。 |
研究合作伙伴
CLARIN这一合作关系于 2015 年建立，CLARIN 将来自欧洲的数字文化遗产数据整合到其研究基础设施中，供学术界使用。 |
DARIAHEuropea 和 DARIAH 致力于改善文化机构数字馆藏的获取条件，并支持学术界将数字文化遗产重新用于研究目的。 |
