README.md in tanita-api-client-0.1.0 vs README.md in tanita-api-client-0.1.1

@@ -1,10 +1,21 @@
 # Tanita::Api::Client
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/tanita/api/client`. To experiment with that code, run `bin/console` for an interactive prompt.
 
+## About
 
+These client libraries are created for [Tanita Health Planet](https://www.healthplanet.jp/) APIs.
+
+refs: [Health Planet API Doc](https://www.healthplanet.jp/apis/api.html) (only Japanese)
+
+### Setup
+
+There are a few setup steps you need to complete before you can use this library:
+
+1. If you don't already have a Health Planet account, [sign up](https://www.healthplanet.jp/entry_agreement.do).
+2. If you have never created a developer application, read the [API Settings page](https://www.healthplanet.jp/apis_account.do) and be enable API.
+
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -19,16 +30,79 @@
 
     $ gem install tanita-api-client
 
 ## Usage
 
-TODO: Write usage instructions here
+### Usage OAuth Helper
 
-## Development
+The library needs to be configured with your account's OAuth settings which is available in your Health Planet Api Settings page.
+Set `client_id` `client_secret` `redirect_uri` `scopes` to its value:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+# OAuth configuration using configure method
+Tanita::Api::Client.configure do |config|
+  config.client_id = '<YOUR_CLIENT_ID>'
+  config.client_secret = '<YOUR_CLIENT_SECRET>'
+  config.redirect_uri = 'http://your-redirect-uri'
+  config.scopes = [Tanita::Api::Client::Scope::INNERSCAN]
+end
+auth_helper = Tanita::Api::Client::Auth.new
+
+# OAuth configuration using initializer
+auth_helper = Tanita::Api::Client::Auth.new(
+  client_id: '<YOUR_CLIENT_ID>',
+  client_secret: '<YOUR_CLIENT_SECRET>',
+  redirect_uri: 'http://your-redirect-uri',
+  scopes: Tanita::Api::Client::Scope.all
+)
+```
+
+Below is the sample get an authentication url and exchange access token from an authentication code.
+
+```ruby
+# get Tanita authentication url
+auth_helper.auth_uri
+=> "https://www.healthplanet.jp/oauth/auth?client_id=YOUR_ID&redirect_uri=http%3A%2F%2F127.0.0.1%2Fcallback&scope=innerscan&response_type=code"
+
+# get access token
+token = auth_helper.exchange_token(auth_code: '<AUTHENTICATION_CODE>')
+=> {:access_token=>"hoge_access_token", :expires_in=>12345678, :refresh_token=>"hoge_refresh_token"}
+```
+
+### Usage Apis Client
+
+The Api client needs access token.
+Set `access_token` to the value you got by above:
+
+```ruby
+# using configure
+Tanita::Api::Client.configure do |config|
+  config.access_token = '<YOUR_ACCESS_TOKEN>'
+end
+api = Tanita::Api::Client::Innerscan.new
+
+# using initializer
+api = Tanita::Api::Client::Innerscan.new(access_token: '<YOUR_ACCESS_TOKEN>')
+
+# fetch innerscan data
+result = api.status
+
+# you can specify a period using params(from:, to:)
+result = api.status(from: Date.current.ago(1.month), to: Date.current)
+
+# list the body-weight data
+result.data.each{|item| puts "#{item[:date]} #{item[:weight]}" }
+>> result.data.each{|item| puts "#{item[:date]} #{item[:weight]}" }
[phone] 66.70
[phone] 66.00
[phone] 66.40
[phone] 66.20
[phone] 65.50
[phone] 66.70
[phone] 66.50
[phone] 66.70
+```
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/koshilife/tanita-api-ruby-client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.