Un jour, une gem

21/05/2012

Lundi c'est Her

gem install her

ORM pour API REST

Her est une gem qui vous donnera un ORM fait pour construire des API. Maintenant pour le tester, quelques petits trucs à faire :

Ajout d’un initializer

Her::API.setup :url => "https://api.example.com" do |builder|
  builder.use Faraday::Request::UrlEncoded
  builder.use Her::Middleware::DefaultParseJSON
  builder.use Faraday::Adapter::NetHttp
end

On ajoute Her aux models

class User
  include Her::Model
end

Vous voilà prêt à l’action ! Et vous avez accès aux url REST :

User.all
# GET https://api.example.com/users et retourne un tableau d'objets user

User.find(1)
# GET https://api.example.com/users/1 et retourne un objet utilisateur

@user = User.create(:fullname => "Tobias Fünke")
# POST "https://api.example.com/users" avec les données et retourne un objet utilisateur

@user = User.new(:fullname => "Tobias Fünke")
@user.occupation = "actor"
@user.save
# POST https://api.example.com/users avec les données et retourne un objet utilisateur

@user = User.find(1)
@user.fullname = "Lindsay Fünke"
@user.save
# PUT https://api.example.com/users/1 avec les données et retourne un objet utilisateur 

Pour la suite vous avez à votre disposition une belle documentation à consommer sans modération :)

Les liens utiles

Sur une idée de @remi