articles-api/README.md

750 B

Articles API

This repository showcases the use of the aicra API engine.

1. download and build the package

go get -u git.xdrm.io/go/articles-api

2. launch in docker

Build the image :

$ docker build -t articles-api .

Run the container :

$ docker run -p 127.0.0.1:8888:4242 articles-api

You can now play with it with any regular REST API client at 127.0.0.1:8888.

2. Play with it

The api.json configuration file defines what this api provides, refer to it to know what requests are available.

Examples :

  • GET /user/12 returns information about the user identified with 12.
  • POST /article given required parameters creates a new article.