"mainsnak": {
"snaktype": "value",
"property": "P31",
"hash": "d679b35e7a9523b92903b52661a9e4c15d8d76d3",
"datavalue": {
"value": {
"entity-type": "item",
"numeric-id": 112826905,
"id": "Q112826905"
},
"type": "wikibase-entityid"
},
"datatype": "wikibase-item"
},
One of the constant pain points that I have heard and run across is this:
Any chance Wikidata's JSON format might be a little more developer friendly
> for tooling in general? Like why do they sometimes have "entity-type" and
> "numeric-id" as keys with dashes, when a lot of the world and our parsing
> libraries have sorta standardized around at least only camelCase or
> snake_case in JSON. I mean, look at what they did with "snaktype" and
> "entity-type" ! Can you find out, Thad ?
So I said to them, sure. đ
(granted I know all characters are allowed for object property names in
JSON and someone likely in the team at the time said, "eh, doesn't matter,
it's JSON, it eats anything".)
Thad
https://www.linkedin.com/in/thadguidry/https://calendly.com/thadguidry/
Hi everyone,
This is a breaking change announcement relevant for some Wikibase API users.
What is Changing?
On 2 July 2024, we will enable the EntitySchema data type on Wikidata, and
we expect the community to create the first properties with that data type
and start using them in statements shortly afterwards. This means that
there will be values with the data value type wikibase-entityid containing
an EntitySchema ID (with "entity-type": "entity-schema" in the JSON value).
However, EntitySchema is not yet a full-featured Wikibase entity type; it
is our intention to eventually make it work like other entity types (Item,
Property, etc.), but at the moment, using EntitySchema in e.g. the
wbgetentities API or Special:EntityData does not work.
Who is Affected?
Code which assumes that IDs found in wikibase-entityid data values can be
used with other Wikibase entity APIs may need adjusting.
Other Wikibases instances besides Wikidata are not affected unless they
also use the EntitySchema extension and set $wgEntitySchemaEnableDatatype =
true.
What You Need to Do
If your code works with statements of arbitrary data types, and looks up
entities referenced in values with the data value type wikibase-entityid,
you probably want to check that the entity-type is not entity-schema before
proceeding. (Note that, if your goal is to display the value, you can
instead use the wbformatvalue API for any data type.)
If you use the wbformatvalue API, you should make sure that you also
specify the datatype or property parameter (depending on which information
you have available; note that specifying both parameters at once is an
error). Without this information, not all values can be formatted
correctly; in particular, trying to format an EntitySchema value without
specifying the datatype or property will result in an error (âAn illegal
set of parameters have been usedâ). (Specifying the datatype or property
parameter for wbformatvalue has always been advisable, and necessary for
some other data value types, but this is the first time it becomes relevant
for wikibase-entityid data values.)
As previously announced
<https://lists.wikimedia.org/hyperkitty/list/wikidata@lists.wikimedia.org/thâŠ>,
the new data type is already enabled on Test Wikidata, so you can try out
the behaviour there. (An example item on Test Wikidata with a statement
linking to an EntitySchema is human <https://test.wikidata.org/wiki/Q497>.)
If you have any questions or concerns about this change, please donât
hesitate to reach out to us in this ticket (T332157
<https://phabricator.wikimedia.org/T332157>).
Cheers,
Lydia
--
Lydia Pintscher - https://lydiapintscher.de - WD:Q18016466
<https://www.wikidata.org/wiki/Q18016466>
Portfolio Lead for Wikidata
Wikimedia Deutschland e. V. | Tempelhofer Ufer 23-24 | 10963 Berlin
Phone: +49 (0)30-577 11 62-0
https://wikimedia.de
Imagine a world in which every single human being can freely share in the
sum of all knowledge. Help us to achieve our vision!
https://spenden.wikimedia.de
Wikimedia Deutschland â Gesellschaft zur Förderung Freien Wissens e. V.
Eingetragen im Vereinsregister des Amtsgerichts Charlottenburg, VR 23855 B.
Als gemeinnĂŒtzig anerkannt durch das Finanzamt fĂŒr Körperschaften I Berlin,
Steuernummer 27/029/42207. GeschĂ€ftsfĂŒhrende VorstĂ€nde: Franziska Heine,
Dr. Christian Humborg