Backlog api
My agent skills
npx -y skills add tsubakimoto/skills --skill backlog-apiAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Backlog(ヌーラボ社のプロジェクト管理SaaS)のREST API v2に関するエキスパートスキル。課題の作成・検索・更新、プロジェクト管理、Wiki操作、Git/プルリクエスト、通知、チーム管理などBacklog APIを使ったコード生成や自動化を支援する。Backlog APIの認証方式、エンドポイント、パラメータ、エラーハンドリングについて質問されたとき、またはBacklog連携スクリプトやアプリを構築するときに使用する。
The file declares its own license as Proprietary. LICENSE has complete terms.. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.7 KB, as published. Nobody here has run it
Backlog API Expert
Backlog API v2 を使った開発を支援するスキル。
API概要
- ベースURL:
https://{スペースID}.backlog.com/api/v2またはhttps://{スペースID}.backlog.jp/api/v2 - 形式: REST API(JSON)
- 公式ドキュメント: https://developer.nulab.com/ja/docs/backlog/
- 詳細なAPI仕様: references/backlog-v2-openapi.yml を参照
前提条件
- Backlogスペースへのアクセス権
- API Key(スペースの「個人設定」>「API」から発行)または OAuth 2.0 アクセストークン
- .NET 10 SDK 以降(C# file-based app 実行用)
認証
API Key認証(クエリパラメータ)
GET /api/v2/space?apiKey=YOUR_API_KEY
OAuth 2.0(Authorizationヘッダー)
Authorization: Bearer YOUR_ACCESS_TOKEN
APIカテゴリ
| カテゴリ | ベースパス | 主な操作 |
|---|---|---|
| スペース | /space | 情報取得、お知らせ、容量、添付ファイル送信 |
| ユーザー | /users | CRUD、認証ユーザー情報、活動履歴、スター |
| チーム | /teams | CRUD、アイコン(/groups は非推奨) |
| プロジェクト | /projects | CRUD、状態・種別・カスタム属性、Webhook |
| 課題 | /issues | CRUD、検索、コメント、添付ファイル |
| Wiki | /wikis | CRUD、タグ、添付ファイル、更新履歴 |
| Git | /projects/.../git/repositories | リポジトリ、プルリクエスト |
| お知らせ | /notifications | 一覧取得、既読化 |
| マスターデータ | /priorities, /resolutions | 優先度・完了理由一覧 |
各エンドポイントの詳細パラメータは references/backlog-v2-openapi.yml を参照。
課題検索パラメータ(GET /issues)
| パラメータ | 説明 |
|---|---|
projectId[] | プロジェクトID(複数指定可) |
statusId[] | 状態ID(複数指定可) |
assigneeId[] | 担当者ID(複数指定可) |
issueTypeId[] | 種別ID(複数指定可) |
keyword | 検索キーワード |
sort | ソート属性(created, updated, dueDate 等) |
order | asc / desc(デフォルト desc) |
count | 取得上限 1-100(デフォルト 20) |
offset | オフセット |
createdSince / createdUntil | 登録日範囲 (yyyy-MM-dd) |
parentChild | 0:すべて, 1:子課題以外, 2:子課題, 4:親課題 |
共通パターン
ページネーション
count(1-100)とoffsetを組み合わせる
複数値パラメータ
statusId[]=1&statusId[]=2
ID指定方式
{issueIdOrKey}: 数値ID または課題キー(例:PROJECT-123){projectIdOrKey}: 数値ID またはプロジェクトキー(例:PROJECT)
C#スクリプト
基本的な操作は C# file-based app の scripts/backlog_api.cs を実行または参照する。
# 実行例
dotnet run --file scripts\backlog_api.cs -- --space myspace --api-key YOUR_KEY get-issues --project-id 12345