(2017/05 ※API v2に対応しました。)
はじめに
バージョン管理だとかパッケージ管理とはあまり触れ合えていないクソエンジニアが、自分のための、ラッパーライブラリ的なやつを書いた報告です。
ラッパーとして書いたので、特定のケースよりも諸々チャットワークでシステムに繋ぎたい時にとりあえず使いはじめるのに向いています。
取り急ぎ、ファイルをお送りさせて頂きます。
https://github.com/git6/php-chatwork-api
(バージョン管理なんて、1人でやってるとCtrl+Sくらい気軽。)
悩んだポイント
前提として、とにかくプレビュー版といいながら
既にある程度機能的なこのAPI(エンドポイント)の構造をこねくり回したくない。
1. まとめるか、まとめないか
同じ対象の、リスト取得と単体取得で分けるか悩みましたが
結局、まとめて単体を指定するIDを渡した場合に単体を取ってくるようにしました。
自分では理解しているけど他の人が使う場合
理解の妨げにならないか、作った後でも不安になっている要素。
(元々エンドポイントは分かれている)
2. エラーの対応をどこまでするか
これも前提から派生する話では有るが、あんまり試してないけども
向こう側でエラーメッセージも出してくれるわけだし
こちら側で判断してライブラリ内からエラーを返すよりも
予めバリデーションなりした値を投げる前提&投げっぱなしで向こうで判断して貰う方が綺麗かなって思った(小並感)
まとめ
クソみたいな現場で使うのに向いてるので、ぜひ最新の現場がやってこない方々に使って欲しいです。
もしこのコードで古いバージョンのPHPで動かないとかあれば、ぜひ対応したいです。
(バージョン上げられない現場とかにぜひ使って欲しい)
Composerとかで使う物は別の方が書かれてますのでそちらをどうぞ。
あと、個人的にはメール通知の代わりに使うケースが多いです。
ちなみに、このコードで一番注意とか欲しいのはクラスの書き方です。
ご指摘待ってます。