api-graph-facebook's Introduction

FACEBOOK API GRAPH

It's a API services to retrieve the profile of one facebook user, using the Facebook API Graph.

HOW TO INSTALL:

Download the source code:

$ git clone https://github.com/maurobonfietti/api-graph-facebook.git
$ cd api-graph-facebook/
$ cp .env.example .env

Edit and complete the config file .env, and then execute:

$ composer install
$ composer start
$ composer test

IMPORTANT NOTE:

For security reasons, I do not publish my FACEBOOK_APP_ID and FACEBOOK_APP_SECRET data on git.

Therefore, if you want to use this service, you will need to complete with your own valid data. In order to do this, you need to register in Facebook developers website: https://developers.facebook.com/apps.

So, first get your App Id (and App Secret Key).
Then, edit and complete the config file: .env:

FACEBOOK_APP_ID = '{YOUR-FB-APP-ID}'
FACEBOOK_APP_SECRET = '{YOUR-FB-APP-SECRET}'
FACEBOOK_APP_VERSION = 'v2.9'

HOW TO USE:

Requests Examples:

Get facebook profile from user '1234':

$ curl http://localhost:8080/users/1234

Response:

Status: 200 OK

{
    "id": "1234",
    "first_name": "Senait",
    "last_name": "Tesfai"
}

Get information about a facebook fan page like 'github':

$ curl http://localhost:8080/pages/github

Response:

Status: 200 OK

{
    "id": "262588213843476",
    "name": "GitHub",
    "about": "GitHub is how people build software.",
    "link": "https:\/\/www.facebook.com\/GitHub\/"
}

RUN TESTS:

Access the root of the project and run all tests PHPUnit with composer test.

$ cd api-graph-facebook/
$ composer test
> phpunit
PHPUnit 6.5.14 by Sebastian Bergmann and contributors.

........                                                             8 / 8 (100%)

Time: 1.94 seconds, Memory: 6.00MB

OK (8 tests, 29 assertions)