Saltar al contenido principal
Inicio - Soporte de OCLC

API de administración de entidades

  1. Última actualización
  2. Guardar como PDF
La traducción de este sitio web se genera mediante traducción automática. La calidad y precisión de la traducción automática pueden variar significativamente de un texto a otro.

 

Descubra los detalles de la API de gestión de la entidad.

Descripción

Mediante la API de administración de entidades, los usuarios pueden crear y editar datos de entidad de WorldCat .

 Nota: se incluye con la suscripción a OCLC Meridian.

Para obtener más información sobre las API de OCLC y empezar a utilizar la Entity Management API, consulte:

Si está listo para comenzar a usar Entity Management API, la Red de desarrolladores de OCLC puede ayudarlo a obtener más información. La Red de desarrolladores de OCLC le permite obtener información sobre las API de OCLC, ver la documentación de las API de OCLC y participar en la comunidad de las API de OCLC.

Acerca de la API de administración de entidades

Alcances de autorización

Funcionalidad Alcance de la autorización
Leer datos de entidad breves entity-management:read_brief_entities
Leer referencias de entidad entity-management:read_references
Leer historial de entidad entity-management:read_history
Entidades de lectura entity-management:read_entities
Editar entidades, incluidas la adición, actualización y eliminación de reclamaciones entity-management:edit_entities
Crear entidades entity-management:create_entities
Fusionar entidades entity-management:merge_entities

Ejemplos

GET v1/management/entities/{id}

Alcance: entity-management:read_entities

Comando GET: https://entities.api.oclc.org/v1/management/entities/E39PBJjCPhTpKwkW7gjMkpjBfq

Código de ejemplo
{ "sameAs": [ "http://www.wikidata.org/entity/Q38453", "http://id.worldcat.org/fast/1206785", "http://id.loc.gov/authorities/names/n79126460", "http://viaf.org/viaf/168448485", "http://sws.geonames.org/4575352" ], "administrativelyPartOf": [ "https://id.oclc.org/worldcat/entity/E39QbtfRBC8KgYHtHkT8CBKfhB" ], "@context": "https://id.oclc.org/api/context.json", "id": "https://id.oclc.org/worldcat/entity/E39PBJjCPhTpKwkW7gjMkpjBfq", "prefLabel": { "ar": "كولومبيا", "be": "Горад Калумбія", "bg": "Колумбия", "bn": "কলাম্বিয়া", "da": "de Columbia", "da": "de Columbia" : "Columbia", "el": "Κολούμπια", "en": "Columbia", "eo": "Columbia", "es": "Columbia", "fa": " mount ": "Columbia", "fr": "Columbia", "fy": "Kolumbia", "gu": "કોલંબિયા", "he": "קולומביה", "hi": "कोलंबिया", "hy": "т": "Columbia", "т": "Columbia", "на": "コロンビア", "ka": "კოლუმბია", "ko": "컬럼비아 ", "ky": "Колумбия", "lt": "Kolumbija", "lv": "Kolumbija", "mk": "Колумбија", "mr": "कोलंबिया", "nl": "Columbia", "nn": "Columbia i Sør-Carolina", "no": "Columbia", "oc": "Columbia", "os": "Колумби", "pi": "कोलम्बिया", "pl": "Columbia ", "pt": "Colúmbia", "ru": "Колумбия", "sa": "कोलम्बिया", "sc": "Colùmbia", "sk": "Columbia", "sr": "Коламбија", "sv": "Columbia", "ta": "கொலம்பியா", "te": "కొలంబియా", "uk": "Колумбія", "ur": "کولمبیا، جنوبی کیرولائنا", "yi": "קאלאמביע" , "zh": "哥伦比亚", "mrj": "Колумби", "sgs": "Kuolumbėjė" }, "altLabel ": { "en": [ "South Carolina--Columbia" ] }, "elevation": [ { "type": [ "Measurement" ], "unit": { "type": [ "Concept " ], "prefLabel": { "en": "feet" } }, "hasValue": "89" } ], "población": [ { "type": [ "Measurement" ], " hasValue": "133803" } ], "type": [ "AdministrativeArea" ], "typeDetail": [ "http://id.worldcat.org/fast/861748" ], "geographicCoordinates": [ "Point(-81.03481 34.00071)" ], "description": { "en": "sede de una división administrativa de primer orden en el condado de Richland, Carolina del Sur, Estados Unidos, América del Norte" } } }

GET v1/management/entities/{id}/references

Alcance: entity-management:read_references

Comando GET: https://entities.api.oclc.org/v1/management/entities/E39PBJjCPhTpKwkW7gjMkpjBfq/references

Código de ejemplo

[ { "digId": null, "version": 1, "agent": "127950", "entity_type": "AdministrativeArea", "change_type": "add", "change_date": "2024-06-03T17: 39:14.2Z", "change_data": { "spatialArea": { "type": [ "Measurement" ], "unit": { "type": [ "Concept" ], "prefLabel": { "en": "sq mi" } }, "hasValue": "45,00" } }, "count": 0 }, { "digId": null, "version": 2, "agent": "127950", "entity_type": "AdministrativeArea", "change_type": "remove" , "change_date": "2024-06-03T17:39:20.65Z", "change_data": { "spatialArea": { "type": [ "Measurement" ], "unit": { "type": [ "Concept" ], "prefLabel": { "en": "sq mi" } }, "hasValue": "45,00" } }, "count": 0 } ]

GET v1/management/entities/{id}/history

Alcance: entity-management:read_history

Comando GET: https://entities.api.oclc.org/v1/management/entities/E39PBJdCvPcj33MDBF4HDyf6rq/history

Código de ejemplo
[ { "property": "elevation", "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$9141ec9c-1173-4846-a198-1dfbfe50fd72","reference_url": "http://sws.geonames.org/4575352", "claim_data": { "elevation": { "type": [ "Measurement" ], "unit": { "type": [ "Concept" ], "prefLabel": { "en": "feet " } }, "hasValue": "89" } } }, { "property": "administrativelyPartOf", "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$be9bd68f-8afb-4d6e-b273-e9153bfe1abe", "reference_url ": "http://sws.geonames.org/4575352", "claim_data": { "administrativelyPartOf": "https://id.oclc.org/worldcat/entity/E39QbtfRBC8KgYHtHkT8CBKfhB" } ) , "claim_data": { "geographicCoordinates": "Point(-81.03481 34.00071)" } }, { "property": "population", "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$fe6f7019-7ac5-45e9-984d-ebe0803ebd9c" , "reference_url": "http://sws.geonames.org/4575352", "claim_data": { "population": { "type": [ "Measurement" ], "hasValue": "133803" } } } ]

PATCH v1/management/entities{id}

Alcance: entity-management:edit_entities

Código de ejemplo
[ { "op": "add", "path": "/occupation", "value": { "label": "Astronaut "languageCode": "en" } } ]

POST /v1/management/entities

Alcance: entidad-gestión:create_entities

PUBLICACIÓN: https://entities.api.oclc.org/v1/entity-management/entity

Código de ejemplo - Respuesta
{ "entityData": { "id": "https://id.oclc.org/worldcat/entity/E39QR8DyfTDkCPH7kfQcBtdpk3", "type": [ "Person" ], "altLabel": { "en": [ "alt label data" ] }, "prefLabel": { "en": "John Glenn", "pl": " John Glenn" }, "description": { "en": "Astronauta y político estadounidense (1921-2016)" }, "occupation": [ { "prefLabel": { "en": "Astronauta" ) "advice": "Contribuya al nivel de calidad agregando una de las siguientes propiedades a la entidad:", "properties": [ "relatedPlace", "honorificSuffix", "activeStartDate", "nominadopara", "relatedFamily", "relatedPerson " ] }, "entityMd5": "05e340eed0d9a39a3084ca1f808b00f3" }