thirdsteplabs/apibase

There is no license information available for the latest version (dev-master) of this package.

Adds CRUD functionality through a RESTful API for Laravel

dev-master 2016-01-17 01:37 UTC

Requires

• php: >=5.4.0
• illuminate/support: 4.2.*
• laravelbook/ardent: 2.*

Unknown License

• Beau Lynn-Miller

• laravel

README

All calls to the API will start with /api/v1/
All responses will be in JSON
If any response other than 200 is given, the JSON will be an array with a code and message element

Login:

• URL: /api/v1/login
• Method: ANY
• Params: username, password OR token
• Response: token
  *All subsequent requests will require that token.

Example: /api/v1/login?username=3333334444&password=fake
Ex Return: {"data":{"token":"12d3ff","user":{"id":2,"username":"3333334444","name":"Beau Lynn-Miller","phone":"3333334444","email":"[e-mail]","created_at":"2014-10-17 10:16:58","updated_at":"2014-10-17 10:17:00","deleted_at":null,"last_offered":null}},"timestamp":"2014-10-17 10:57:05","hashes":{"gpsConfig":"422962d8","vehicles":"86e45d7c","towingCompanies":"011500b9","states":"738ee935"}}

Get All:

• URL: /api/v1/{object}
• Method: GET
• Params: token
• Response: array of object data

Example: /api/v1/user?token=12d3ff
Ex Return: [{"id":1,"name":"Fakey McFakerson","email":"[e-mail]"},{"id":2,"name":"Foo McBarenson","email":"[e-mail]"}]

Get Specific:

• URL: /api/v1/{object}/{id}
• Method: GET
• Params: token
• Response: object data

Example: /api/v1/user/2?token=12d3ff
Ex Return: {"id":2,"name":"Foo McBarenson","email":"[e-mail]"}

Create Object:

• URL: /api/v1/{object}
• Method: POST
• Params: token, fillabe parameters defined in model
• Response: object data

Example: /api/v1/user?name=Testey&password=test&email=[e-mail]&phone=5551234123&token=12d3ff
Ex Return: {"id":3,"name":"Testey","email":"[e-mail]","phone":"5551234123"}

Update Object:

• URL: /api/v1/{object}/{id}
• Method: PUT
• Params: token, fillabe parameters defined in model
• Response: object data

Example: /api/v1/user/2?phone=5557777777&token=12d3ff
Ex Return: {"id":2,"name":"Foo McBarenson","email":"[e-mail]","phone":"5557777777"}

Delete Object:

• URL: /api/v1/{object}/{id}
• Method: DELETE
• Params: token
• Response: array of remaining objects

Example: /api/v1/user/1
Ex Return: [{"id":2,"name":"Foo McBarenson","email":"[e-mail]","phone":"5557777777"},{"id":3,"name":"Testey","email":"[e-mail]","phone":"5551234123"}]

Logout:

• URL: /api/v1/logout
• Method: ANY
• Params: token
• Response: JSON with message

Example: /api/v1/logout?token=12d3ff
Ex Return: {"message":"Logout successful"}

Error:

Making a call without a token will result in an error:

Example: /api/v1/user
Ex Return: {"code":401,"message":"You do not have access to view this web page"}