Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gvolpe/social-graph-api
Authentication & Social Graph API built on top of Redis, Neo4J and Play!
https://github.com/gvolpe/social-graph-api
anorm-cypher graphdb neo4j playframework redis silhouette
Last synced: 2 months ago
JSON representation
Authentication & Social Graph API built on top of Redis, Neo4J and Play!
- Host: GitHub
- URL: https://github.com/gvolpe/social-graph-api
- Owner: gvolpe
- License: other
- Created: 2015-02-26T21:19:34.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2015-07-10T13:10:27.000Z (over 9 years ago)
- Last Synced: 2023-03-25T15:07:50.636Z (over 1 year ago)
- Topics: anorm-cypher, graphdb, neo4j, playframework, redis, silhouette
- Language: Scala
- Homepage:
- Size: 1.31 MB
- Stars: 13
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
social-graph-api
================
[](http://travis-ci.org/gvolpe/social-graph-api)
[](https://coveralls.io/r/gvolpe/social-graph-api)
[](http://waffle.io/gvolpe/social-graph-api)
[](https://www.codacy.com/public/volpegabriel/social-graph-api)
[](https://social-graph-api.herokuapp.com)
This is an open source Social Graph API licensed under the Apache 2 license, quoted below.
Continuous Delivery: [](https://codeship.com/projects/67002)
## About the project
Social Graph API (SGA) was built on top of [Play! Framework](https://www.playframework.com/).
You can see a [live demo](https://social-graph-api.herokuapp.com) deployed at Heroku.
## Authentication
SGA uses [Silhouette](http://silhouette.mohiva.com/) with the JWTAuthenticator (Json Web Token) to secure the API.
To save the data of the authentication layer uses [Redis](http://redis.io).
## Social Graph Store
SGA uses [Neo4j](http://neo4j.com) as a graph store.
As a Scala client library uses [AnormCypher](http://anormcypher.org/).
## Authentication API usage
### Sign Up
Request:
```
curl -X POST -H "Content-Type: application/json" -d '{ "identifier": "[email protected]", "password":"123456" }' https:///auth/signup
```
Responses:
* 200: Ok --> Sign up ok
* 209: Conflict --> User already exists
### Sign In
```
curl -X POST -H "Content-Type: application/json" -d '{ "identifier": "[email protected]", "password":"123456" }' https:///auth/signup
```
Responses:
* 200: Ok --> Sign in ok
* 401: Unauthorized --> Wrong user and/or password
When Sign Up and/or Sign In http response code is 200 the response body is like this:
```json
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE0MjU1NDExMTEsInN1YiI6ImU5MmIyNDA1NTQ5YzUzZWM3NWExZWMyYWFjYTllZTViMGQ0MWFkNDNmZmJkOTk0YzQzMmEzY2E4ZjhmODhlM2FkN2RjMjhiZmUwOWE5NzEyNWU3Y2I0YzcxNGY3NzAzOGQxNGQxMzlkOWY4NmEyZGQxMDRkNjkwMmU3MTQ4YzdhIiwiaXNzIjoicGxheS1zaWxob3VldHRlIiwianRpIjoiYmE1ZDE5NDMxODY2MzY1NzJhMDgwNzhlNmYwYTZlOGJiOWFjOGJlNzFlMmI0N2Y1NmM1MjQzZjc1MTcyOTQyZmVkMzdlZTRjZWZiNTM0M2ZmYzlkZThlN2JkNjRlMzdkNDE5Mjk3NmM4ZjI0ZjJhNDA5ZTBiOTZhNTMyOTQ3NmM5YzU0NjRiODgxNjUzZWJmY2Q1MzNkN2QyMDIxMzVmODEzZjE1YTBmZTk3OTYzZjczZDYxMmM3ZjcwMTljODIzYzA0OTUzYTJkYjIzZWY0MmY2NzUzZDExN2EzN2QyZjJhMmE5YzAxYzgwZjkzNTUwZjBkZmY3ZGRmYmE0N2FlMiIsImlhdCI6MTQyNTQ5NzkxMX0.ySOKjDPhX2Ghw5ZvWq9A_1BlW2oLl12ncEjzMCY5-ow",
"expiresAt": "2015-03-05T04:38:31.795-03:00"
}
```
## Users API usage
### Retrieve all the users
#### GET /api/v1/users
Request:
```
curl -X GET -H 'X-Auth-Token:hash3d-t0k3n' https:///api/v1/users
```
Response:
```json
[
{
"id": 5,
"username": "foobar",
"email": "[email protected]"
},
{
"id": 6,
"username": "gvolpe",
"email": "[email protected]"
},
...
]
```
### Retrieve user by Id
#### GET /api/v1/users/{id}
Request:
```
curl -X GET -H 'X-Auth-Token:hash3d-t0k3n' https:///api/v1/users/6
```
Response:
```json
{
"id": 6,
"username": "gvolpe",
"email": "[email protected]"
}
```
### Create an user
#### POST /api/v1/users
```
curl -X POST -H 'X-Auth-Token:hash3d-t0k3n' -H "Content-Type: application/json" -d '{ "username": "gvolpe", "email": "[email protected]" }' https:///api/v1/users
```
### Delete an user and his relationships
#### DELETE /api/v1/users/{id}
```
curl -X DELETE -H 'X-Auth-Token:hash3d-t0k3n' https:///api/v1/users/3
```
## Social Graph API usage
### Retrieve followers by Id
#### GET /api/v1/followers/{id}
Request:
```
curl -X GET -H 'X-Auth-Token:hash3d-t0k3n' https:///api/v1/followers/4
```
Response:
```json
[
{
"id": 5,
"username": "foobar",
"email": "[email protected]"
}
]
```
### Retrieve friends (AKA following) by Id
#### GET /api/v1/friends/{id}
Request:
```
curl -X GET -H 'X-Auth-Token:hash3d-t0k3n' https:///api/v1/friends/2
```
Response:
```json
[
{
"id": 3,
"username": "gvolpe",
"email": "[email protected]"
}
]
```
### Create a friendship
It creates a FRIEND relationship from A to B and a FOLLOWER relationship from B to A.
#### POST /api/v1/friendship
```
curl -X POST -H 'X-Auth-Token:hash3d-t0k3n' -H "Content-Type: application/json" -d '{ "me": 7, "friend": 3 }' https:///api/v1/friendship
```
### Delete a friendship
Delete FRIEND and FOLLOWER relationships between two users.
#### DELETE /api/v1/friendship
```
curl -X DELETE -H 'X-Auth-Token:hash3d-t0k3n' -H "Content-Type: application/json" -d '{ "me": 7, "friend": 3 }' https:///api/v1/friendship
```
## License
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with
the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
language governing permissions and limitations under the License.