Very simple micro service with even simpler token based authentication.

Easy peasy, simply run the following commands:

• git clone repository url
• composer install
• artisan:migrate

Duplicate .env.example and edit the following line to the bottom of your freshly created .env file. This will be the api token your other applications use to gain access to your micro-service. You should have secured your micro-services within a VPC or similar WAF to protect against unauthorised calls, but this gives you just that extra bit of protection, should you really need it.

API_TOKEN=TOKEN_GOES_HERE

All end points require an api_token header, which is the same as the one you set in your .env file.

GET /posts/all

Requires the following header:

• api_token the api token you added to your .env file (required)

Returns JSON

// Valid response 200
{
  'success': true,
  'data': [
    {
      'id': (int) // post id,
      'user_id': (int) // user id of post,
      'title': (string) // post title,
      'content': (string) // post content,
      'created_at': (string) // created time eg: 2017-03-24 11:47:12,
      'update_at': (string) // updated time eg: 2017-03-24 11:47:12
    }
  ]
}

// Invalid response {response code}
{
  'success': false,
  'data': {
    'message': (string),
  }
}

GET /posts/get/{id}

Accepts the following parameters:

• {id} being the id of the post you are requesting (required).

Accepts the following header:

• api_token the api token you added to your .env file (required)

Returns JSON

// Valid response 200
{
  'success': true,
  'data': {
    'id': (int) // post id,
    'user_id': (int) // user id of post,
    'title': (string) // post title,
    'content': (string) // post content,
    'created_at': (string) // created time eg: 2017-03-24 11:47:12,
    'update_at': (string) // updated time eg: 2017-03-24 11:47:12
  }
}

// Invalid response {response code}
{
  'success': false,
  'data': {
    'message': (string),
  }
}

PUT /posts/{api_token}/insert

Accepts the following parameters:

• user_id (int) id of user that owns post (required)
• title (string) post title (required)
• content (string) post content (required)

Accepts the following header:

• api_token the api token you added to your .env file (required)

Returns JSON

// Valid response 200
{
  'success': true,
  'data': {
    'id': (int) // post id,
    'user_id': (int) // user id of post,
    'title': (string) // post title,
    'content': (string) // post content,
    'created_at': (string) // created time eg: 2017-03-24 11:47:12,
    'update_at': (string) // updated time eg: 2017-03-24 11:47:12
  }
}

// Invalid response {response code}
{
  'success': false,
  'data': {
    'message': (string),
  }
}

DELETE /posts/{api_token}/delete

Accepts the following parameter:

• id (int) id of post you wish to delete (required)

Accepts the following header:

• api_token the api token you added to your .env file (required)

Returns JSON

// Valid response 200
{
  'success': true,
  'data': {
    'id': (int) //post id
  }
}

// Invalid response {response code}
{
  'success': false,
  'data': {
    'message': (string),
  }
}

PUT /posts/{api_token}/update

Accepts the following parameters:

• id (int) id of post to update (required)
• user_id (int) id of user that owns post
• title (string) post title
• content (string) post content

Accepts the following header:

• api_token the api token you added to your .env file (required)

Returns JSON

// Valid response 200
{
  'success': true,
  'data': {
    'id': (int),
    'user_id': (int),
    'title': (string),
    'content': (string),
    'created_at': (string),
    'update_at': (string)
  }
}

// Invalid response {response code}
{
  'success': false,
  'data': {
    'message': (string),
  }
}

Easy, just run the command phpunit from the root directory, composer should install this for you.

• Get posts by user id
• Bulk update / edit / insert / get
• Validation and better error responses
• Better managment of tokens