Project

kuroneko

0.0
No commit activity in last 3 years
No release in over 3 years
クロネコヤマトの荷物追跡を照会する
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
>= 0

Runtime

~> 2.7
 Project Readme

Kuroneko

クロネコヤマトの荷物追跡を照会する

See also: http://toi.kuronekoyamato.co.jp/cgi-bin/tneko

Installation

Add this line to your application's Gemfile:

gem 'kuroneko'

And then execute:

$ bundle

Or install it yourself as:

$ gem install kuroneko

Usage

最新状態を取得する

require "kuroneko"

status = Kuroneko.status("1234-5678-9012")
#=> #<struct Kuroneko::Status>

status.number
#=> "123456789012"

status.status
#=> "配達完了"

status.to_h
  => {
    number: "123456789012",
    status: "配達完了",
    date:   "12/31",
    time:   "12:59",
    branch: "北東京ベース店",
    branch_code: "030990"
  }
  • 履歴のうち最新の Kuroneko::Status#latest?true を返します。
  • Kuroneko#statuses で複数を一度に照会でき、結果は Array で返されます。

状態履歴を取得する

history = Kuroneko.history("1234-5678-9012")
#=> #<Kuroneko::History<Kuroneko::Status>>
  • HistoryArray を継承していて、以下を追加で実装しています。
    • 履歴のうち最新の状態を返す #latest
    • 伝票番号を返す #number
  • Kuroneko#histories で複数を一度に照会でき、結果は Array で返されます。

英語版を利用する

- require "kuroneko"
- neko = Kuroneko.new
+ require "kuroneko/en"
+ neko = Kuroneko::En.new

英語版を使うと担当店 / 担当店コードは取得できません。

伝票番号

#status, #statuses, #history, #histories に渡す伝票番号は そのまま問い合わせに使用するため、クロネコヤマト側が受け付ける形式であれば どのようなものでも可能です。

Kuroneko::History, Kuroneko::Status から読み取る伝票番号は 照会結果から取得し、数字のみからなる 文字列 で返ります。

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request