specs

specs copied to clipboard

JSON-LD responses: make them FAIR.

7

I think it's great to standardise on what a reconciliation API should and shouldn't do, but I strongly favour ensuring that the API response is in line with the W3C...

RinkeHoekstra

Returning errors for individual queries

7

Sometimes, reconciliation queries can be invalid, for all sorts of reasons: * their JSON structure does not fit the schema * they contain references to objects that do not exist...

wetneb

SemTab matching (joint entity linking)

12

http://www.cs.ox.ac.uk/isg/challenges/sem-tab/ Describes a task called - Tabular Data to Knowledge Graph Matching, or - Entity Linking for Tabular Data The key difference is this: - Reconciliation matches **one** column (with...

VladimirAlexiev

Add note about throttling

1

We should add a not about how services should throttle queries. Probably using standard HTTP mechanisms like a `Retry-After` header - so there is probably not much to specify except...

wetneb

richer responses in the reconciliation API for more NER-like queries

2

We've been exploring using the Reconciliation API in a smart building/smart grid/IoT setting: we have sensor names (and only sensor names) from legacy industrial equipment and we want to predict...

epaulson

Currently the spec says: - `type_strict`: Optionally, a type strictness parameter, which can be one of the strings "should", "all" or "any". - (later) - NOTE: The meaning of the...

VladimirAlexiev

Introduce "properties_strict" for strictness of attributes that must be present

4

As I mentioned in PR #23 I think there might be a need to introduce something similar to the existing `type_strict` but for `properties`. > I think this is useful...

thadguidry

`score` vs `match`

6

## Recon spec https://reconciliation-api.github.io/specs/latest/#reconciliation-query-responses includes two characteristics that determine the "quality" of a candidate: - `score` (numeric) and - `match` (boolean) I think these rules would make sense: - `match`...

VladimirAlexiev

Clarify the requirements on the "matched" attribute

1

Reconciliation candidates returned by services can contain a `"matched"` attribute, which indicates whether the service predicts that the entity matches the query. At the moment, we do not specify anything...

wetneb

full-text matching

1

I think that in many cases it will be useful to match rows by their textual content, using it as a general context for the entities in the KB. NLP...

VladimirAlexiev