Community articleEvidence Element
Added by IBM contributorIBM on March 27, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

No abstract provided.

Background


In some cases when an application answers a social search request, it is important for the response to provide evidence of why the particular results were returned. For example, in the context of the Social Recommendations API, adding evidence has been shown to increase users' trust in the system. Another example is the Social Network (Graph) API, when looking for people related to some person, providing evidence helps the user understand the person-to-person associations.

In light of this, the Search API responses can be augmented with two type of evidence elements: entity_evidence and association_evidence.

Response elements definitions

Element
Description
ibmss:entity_evidence
Defines an entity evidence element.
ibmss:entity_evidence/@type
The type of the evidence element. Must comply with the types defined for "social" elements in Search API.
ibmss:entity_evidence/@id
The identifier of the evidence element.
ibmss:association_evidence
Defines an association evidence element between two entities. No body allowed for association_evidence elements.
ibmss:association_evidence/@from
The entity from which the association evidence points.
ibmss:association_evidence/@to
The entity to which the association evidence points.
ibmss:association_evidence/@type
The type of the association.
ibmss:association_evidence/@count
The number of associations of the given type between the two involved entities.