=== Narrative==== User Story
**Android**>====== As a mobile reader (familiar with editing on my device)
- As a mobile reader (familiar with editing on my device)>====== When I am reading an article with no images
-- 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.
**Structured Data**
- As a bot-writing contributor
=== Acceptance Criteria
-- I want a list of unillustrated pages and image recommenda[] Given I have made a request with a single page, `cat`, I expect to see the image suggestions perfor that page
-- So that I can automate adding images to those pages
=== Context[] Given I have made a request with n pages, (`cat`, `dog`, ...) I expect to see the list of pages and their respective image suggestions
This is for a per article basis, being able to request the image recommendations we need
=== Acceptance Criteria
Hygiene
[] The service is deployed and reachable via curl
[] API Documentation is published and viewable
[] Tests related to ACs are written and pass
======= Example SpecRequest/Response
**Request**
```
https://api.wikimedia.orgGET `/image_recommenda-suggestion/v1s/v0/wikipedia/en/?page_title="Frog"pages/1,2`
```
**Response**
HTTP 200
```
{
"project": enwiki"pages": [
"page" "Frog" {
[ "project": "enwiki",
"page": "Cat",
"suggestions": [
{
"filename": "Mountain Lion.jpg",
"original-size": "1800",
"thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Mountain_Lion.jpg/{width}px-Mountain Lion.jpg",
"confidence_rating": "low",
"source": {
"name": "ima",
"details": {
"model_version": 1.0
}
}
},
{
"filename": "Bengal Tiger.jpg",
"original-size": "1800",
"thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Bengal_Tiger.jpg/{width}px-Bengal Tiger.jpg",
"confidence_rating": "low",
"source": {
"name": "ima",
"details": {
"model_version": 1.0
}
}
}
},
{
"image": "image 1" "project": "enwiki",
"page": "Dog",
"suggestions": [
{
"filename": "Poodle.jpg",
"original-size": "1800",
"thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Poodle.jpg/{width}px-Poodle.jpg",
"confidence_rating": "low",
"source": {
"name": "ima",
"details": {
"model_version": 1.0
}
}
},
{
"image": "image 2" "filename": "Shiba Inu.jpg",
"original-size": "1800",
"thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Shiba Inu.jpg/{width}px-Shiba Inu.jpg",
"confidence_rating": "low",
"source": {
"name": "ima",
"details": {
"model_version": 1.0
}
}
}
}
]
}
```
=== Open Questions
[] Are we able to query suggestions by `page_id` or just `page_title`?
[] If title is only available, should we require the request to have a payload of pages? or keep inline as URI parameter
[] Is image information like `original_size` or `thumbnail` currently available via the dataset?
=== Subtasks
[]