A sample application showing how to use grape to create a simple blog api.
Switch branches/tags
Nothing to show
Clone or download
bloudraak Merge pull request #1 from patcon/patch-1
Fixes README erratum (update should use PUT).
Latest commit 6dab9a1 Mar 3, 2013
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
config
db
doc
lib Added the default rails application Sep 8, 2012
log Added the default rails application Sep 8, 2012
public
script
test
vendor Added the default rails application Sep 8, 2012
.gitignore
Gemfile
Gemfile.lock Added an basic api to manage weblogs, posts and comments Sep 8, 2012
LICENSE.md
README.md
README.rdoc
Rakefile
config.ru

README.md

Blog API

This is a example application showing how to use grape to create a simple API. This sample show cases how to create a simple API without authentication, caching, custom errors, entities and such other things to build a robust public API.

I wrote the sample because I was unable to find a sample to cover the basics of grape.

Environment

The sample was developed using the following software. If your software is different, the sample may still work, but there is no guarantee.

  1. Rails 3.2.8
  2. ruby 1.9.3p194
  3. OS X 10.8.1 (aka Mountain Lion)
  4. Grape (0.2.1)

Setup

Install the gems

bundle install

Create and migrate the database

rake db:migrate

Seed the database

rake db:seed

Running the sample

You can run the server using the built-in rails server

rails server

Usage

Getting all the weblogs

curl -i http://localhost:3000/weblogs

Creating a weblog

curl -d '{"title": "Dummy"}'  -X POST -H Content-Type:application/json http://localhost:3000/weblogs

Deleting a weblog

curl -X DELETE http://localhost:3000/weblogs/1

Updating a weblog

curl -d '{"title": "Another Weblog"}' -X PUT -H Content-Type:application/json http://localhost:3000/weblogs/2

Get the posts of the weblog #2

curl -i http://localhost:3000/weblogs/2/posts

Create a post in a weblog #2

curl -d '{"title": "Dummy"}'  -X POST -H Content-Type:application/json http://localhost:3000/weblogs/2/posts

Delete all posts in weblog #2

curl -X DELETE http://localhost:3000/weblogs/2/posts

Updating a post

curl -d '{"title": "Dummy"}'  -X PUT -H Content-Type:application/json http://localhost:3000/posts/2

Delete all posts

curl -X DELETE http://localhost:3000/posts

Delete a specific post

curl -X DELETE http://localhost:3000/posts/2

Delete all comments from post #2

curl -X DELETE http://localhost:3000/posts/2/comments

Create a comment in a post #2

curl -d '{"name": "Bob"}'  -X POST -H Content-Type:application/json http://localhost:3000/posts/2/comments

Get a comment #2

curl http://localhost:3000/comments/2

Delete a comment #2

curl -X DELETE http://localhost:3000/comments/2

Delete all comments

curl -X DELETE http://localhost:3000/comments

Updating comment #2

curl -d '{"name": "Sam"}' -X PUT-H Content-Type:application/json http://localhost:3000/comments/2