API de administración de entidades

Rutas

Recuperar - GET v1/management/entities/{id}
Recuperar referencias - GET v1/management/entities/{id}/references
Recuperar historial - GET v1/management/entities/{id}/history
Actualizar entidad - PATCH v1/management/entities/{id}
Crear entidad - POST v1/management/entities/

Alcances de autorización

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" }