README.md

Syfony Flex API Starter

This in an API starter kit built with Symfony flex and FOS bundles that help achieve a full fledged rest API with an OAuth 2.0 server.

Getting Started

Simply clone this repo, run composer install, modify your .env file and run php bin/console server:run to view the live development server!

What does it include?

• FOSRESTBundle
• FOSOAuthServerBundle
• FOSUserBundle
• NelmioAPIDocBundle
• JSMSerializerBundle

Help me set up?

Sure. Getting setup with the available console commands can help make your life much easier during this initial process.

First things you may want to do are to setup a user and oauth client to make requests with.

php bin/console fos:user:create

Followed by

php bin/consle api:client:create

With your newly created client, you can authenticate with the OAuth server and user, so long as you at least had chosen the password grant type, otherwise authorize with the client_credentials spec.

curl -X POST \
  http://localhost:8000/oauth/v2/token \
  -H 'accept: application/json' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'client_id=%client_id%&client_secret=%client_secret%&grant_type=client_credentials'

And you'll get your token!

{
    "access_token": "YmZkNmNmN2I1Y2E3MGFhZTIzMjE0N2UyMGYyZTdjZTBiYzk4NzE4M2ExZTY3YThjODhkYzIxNDBkMjNiN2UzZg",
    "expires_in": 3600,
    "token_type": "bearer",
    "scope": "user"
}