140 | | == Responding GET api/annotations/AIDzyy (example usage for unresolvable target sources) == |
141 | | |
142 | | The respond for an annotation with unresolved target sources and the respond for an annotation with resolved target sources (see above) are both instances of the same schema element. However, the annotation refers to an obsolete version of the page. Next, having the target source references, the client will ask for the cached representations of the obsolete web-page. |
143 | | |
| 140 | == Responding GET api/annotations/AIDzyy (example usage for unresolvable target sources 1) == |
| 141 | |
| 142 | The respond for an annotation with unresolved target sources and the respond for an annotation with resolved target sources (see above) are both instances of the same schema element. However, the annotation refers to an obsolete version of the page. Next, having the target source references, the client will ask for the source versions saved in the DB. The last step: having the info about the version under consideration, the client asks for cached representations of the version. |
188 | | <cachedRepresentations> |
189 | | <cachedRepresentation ref="http://dasish.eu/cached/CIDtttt"/> |
190 | | <cachedRepresentation ref="http://dasish.eu/cached/CIDttxvv"/> |
191 | | </cachedRepresentations> |
192 | | <versions-siblings> |
193 | | <version ref="http://dasish.eu/sources/SIDaacc"/> |
194 | | </versions-siblings> |
195 | | </source> |
196 | | }}} |
197 | | |
198 | | === Remarks by Menzo === |
199 | | |
200 | | |
201 | | For very dynamic and popular target sources the version list might become big, that could be a reason to move it to a separate call. Actually we have already GET api/sources/<sid>/versions, so I would leave them out here. |
202 | | |
203 | | === Olha's comment:=== |
204 | | We have agreed earlier that the list of versions would include all the "siblings", include the source itself.Are there alternative ways to get all the siblings of a given source? |
205 | | |
206 | | |
207 | | == Responding GET api/sources/SIDbbb/cached/CIDtttt/metadata (completing the example with the unresolvable target sources) == |
| 187 | <versions-siblings ref="http://dasish.eu/versions/VIDaacc"/> |
| 188 | </source>}}} |
| 189 | |
| 190 | |
| 191 | == Responding GET api/versions/VIDaacc (unresolvable target sources 3) == |
| 192 | |
| 193 | == Responding GET api/sources/SIDbbb/cached/CIDtttt/metadata (completing the example with the unresolvable target sources 4) == |