Narrative
- As a mobile reader (familiar with editing on my device)
- When I am reading an article with no images
- I want to see any image(s) that could be used to illustrate the article,
- so that I can both gain a better understanding of the topic, as well as contribute to helping others who read the article in the future.
Acceptance Criteria
- As the StructuredData, I want the ability to request unillustrated pages that have image suggestions only from the image source MediaSearch, so that I am able to determine which
- As the Android Product Manager, I want the ability to request unillustrated pages that have image suggestions only from the image sources of Wikidata, Commons, and other Wikipedias, so that I am able to determine the accuracy of the ImageMatchingAlgo results.
Example Spec 1: Generic
Request
GET https://api.wikimedia.org/image_suggestions/v1/en/wikipedia/pages?source=[ima|ms]
Note: ima = Image Matching Algorithm, ms = MediaSearch. We could easily allow aliases of fully-spelled-out terms, like "image-matching-algorithm" and 'media-search", or whatever callers would find mnemonic. Suggestions welcome. But short versions are convenient for keeping logs readable.
Response
{
"project": enwiki
"page" "Cat"
[
{
"filename": "File:Striped_Cat.jpg",
"source": "Wikidata",
"confidence_rating":"high"
},
{
"filename": "File:Spotted_Cat.jpg",
"source": "Commons Category",
"confidence_rating":"medium"
},
]
},
{
"project": enwiki
"page" "Frog"
[
{
"filename": "File:Green_Frog.jpg",
"source": "Wikidata",
"confidence_rating":"high"
},
{
"filename": "File:Yellow_Frog.jpg",
"source": "Commons Category",
"confidence_rating":"medium"
}
]
}Note: this response is unchanged from the response without filtering. The source is echoed, even though it will initially be known, both for consistency and because we may in the future allow filtering for multiple sources (once we have more).