Image Search Abstraction Layer

Get image results through the Unsplash API.

How it Works

This microservice uses Monk to store and retrieve objects, unsplash-js and isomorphic-fetch to fetch results from the Unsplash API, and Koa and koa-router to serve requests.

How to Use

app.js exports a Koa app. Koa apps have an app.listen() method that is identical to Node's http.Server.listen().

Import app.js and call app.listen() to start up the microservice.

Environment Variables

• APPLICATION_ID - required to authenticate requests to the Unsplash API
• MONGO_URI - your Mongo database's connection string

API Resources

GET /search

Get a list of sparse photo metadata for a query.

REQUEST

Sample: https://image-search-abstraction-layer.example.com/search?keyword=chickadee

QUERY PARAMETERS

| parameter | type | default | |-----------|--------|---------| | keyword | string | — | | offset | number | 1 | | per_page | number | 10 |

RESPONSE

Status: 200 - application/json

Response:

[
  {
    "user": {
      "name": "Paulo Brandao",
      "small": "https://images.unsplash.com/placeholder-avatars/extra-large.jpg…",
      "html": "https://unsplash.com/@pbrandao"
    },
    "photo": {
      "small": "https://images.unsplash.com/uploads/141155339325423394b24/03982423…",
      "html": "https://unsplash.com/photos/YLgTmdb7r1o"
    }
  }
]

GET /latest

Get a list of the latest queries.

REQUEST

Sample: https://image-search-abstraction-layer.example.com/latest

RESPONSE

Status: 200 - application/json

Response:

[
  {
    "keyword": "chickadee",
    "when": "Sat, 01 Oct 2016 00:00:00 GMT"
  }
]