README.en.md in rakuten_web_service-0.6.2 vs README.en.md in rakuten_web_service-0.6.3
- old
+ new
@@ -47,24 +47,31 @@
* [Rakuten Kobo Ebook Search API](http://webservice.rakuten.co.jp/api/koboebooksearch/)
* [Rakuten Kobo Genre Search API](http://webservice.rakuten.co.jp/api/kobogenresearch/)
## Usage
+### Prerequisite: Getting Application ID
+
+You need to get Application ID for your application to access to Rakuten Web Service APIs.
+If you have not got it, register your appplication [here](https://webservice.rakuten.co.jp/app/create).
+
### Configuration
`RakutenWebService.configuration` allows you to specify your application's key called application\_id and your affiliate id(optional).
```ruby
RakutenWebService.configuration do |c|
- c.application_id = YOUR_APPLICATION_ID
- c.affiliate_id = YOUR_AFFILIATE_ID
+ c.application_id = 'YOUR_APPLICATION_ID'
+ c.affiliate_id = 'YOUR_AFFILIATE_ID'
end
```
+Please note that you neet to replace `'YOUR_APPLICATION_ID'` and `'YOUR_AFFILIATE_ID'` with actual ones you have.
+
### Search Ichiba Items
```ruby
- items = RakutenWebService::Ichiba::Item.search(:keyword => 'Ruby') # This returns Enamerable object
+ items = RakutenWebService::Ichiba::Item.search(:keyword => 'Ruby') # This returns Enumerable object
items.first(10).each do |item|
puts "#{item['itemName']}, #{item.price} yen" # You can refer to values as well as Hash.
end
```