Download the PHP package takuya/php-nulab-backlog-api-client without Composer
On this page you can find all versions of the php package takuya/php-nulab-backlog-api-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download takuya/php-nulab-backlog-api-client
More information about takuya/php-nulab-backlog-api-client
Files in takuya/php-nulab-backlog-api-client
Package php-nulab-backlog-api-client
Short Description Access to Nulab Backlog Api.
License GPL-3.0-or-later
Informations about the package php-nulab-backlog-api-client
Nulab Backlog APIアクセス用
目標:NulabのBacklog APIに快適にアクセスして、全データを取り出せるようにする。
バックログのスペースとプロジェクト内部を探索してデータを探すのが面倒なので、データを網羅的に探せるようにしてある。
基本的な使い方。
spaceId はURLを入れます。
提供するクラス
2つのクラスファイルを提供しています。
class BacklogAPIClient更新・取得用class Backlog取得専用
class Backlog はID探索のために作っています。更新は実装していません。
class BacklogAPIClient を使って更新をします。
認証
APIキーのアクセスを実装しています。OAUTHアクセスキー(BEARERトークン)は実装していません。
特長
PHPStormのIDE自動補完を使えるようにした。
データモデルをModelクラスとして作成した。これによりスペース→プロジェクト→課題->コメント->通知 のBacklog階層構造を辿れる。
階層構造でたどれば、全体を取得しやすくなる。
サンプル
自動補完の例
BacklogのAPIのメソッド名を自動補完します。
サンプル
APIはバックログを開いてアドレスを見ながら使います。
課題コメントを開いたときのアドレスは次のようになっています。
アドレスから次の情報が読み取れます。
| URL(path) | 値 | Apiでの引数表記 | 呼び方 |
|---|---|---|---|
| /MYPRJ-40#comment-8408 | MYPRJ | ProjectIdOrKey | ProjectKey |
| /MYPRJ-40#comment-8408 | 40 | IssueIdOrKey | IssueKey |
| /MYPRJ-40#comment-8408 | 8409 | CommentId | CommentId |
APIドキュメントにProjectIdOrKeyと書かれた場合は、 ProjectId Or ProjectKey を意味しています。ProjectKeyとProjectIdとは1対1対応のようです。
上記の情報を使ってAPIにアクセスします。
たとえば、以下のように使います。
基本的に、KeyよりIDアクセスが楽ちんです。
なぜなら、リクエスト引数へIDsを指定で検索するAPIが殆どだからです。たとえばパラメータprojectIds[]やIssueIds[]などです。
このためにID と Key を相互に変換するメソッドを作成してあります。
api 一覧
APIの名前とメソッド名と実際のAPIの対応表をapi.htmlに用意しています。
日付と時刻
BacklogのAPIは created / updated で日付が返されます。すべてUTCのようです。
インストール via github
インストール via packagist with composer
Development
インストールしてテストして開発。
サンプル
更新をするときのサンプル
画像の投稿のサンプル
画像を投稿して、画像を貼り付けたコメントを作る。
All versions of php-nulab-backlog-api-client with dependencies
guzzlehttp/guzzle Version >=7.5
ext-json Version *
ext-gd Version *
takuya/php-genetator-array-access Version ^1.0
doctrine/inflector Version ^2.0