Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Qiita API v2 client library and CLI tool, written in Ruby
branch: master

Merge pull request #11 from kmrshntr/master

前のページのリンクが取れないので修正する。
latest commit 7a1e29f0e8
Ryo Nakamura r7kamura authored
Failed to load latest commit information.
bin Add `qiita` executable as a CLI Tool
doc Add --no-ssl-verification option
images Update screenshot
lib 前のページのリンクが取れなかったので修正
script Support multi arguments client methods
spec Support --host with --team option
.gitignore Add some make commands for building
.travis.yml Requires 2.0.0 or higher on travis-ci
CHANGELOG.md v1.1.2
Gemfile Execute `bundle gem qiita`
LICENSE.txt Prepare for API v2
Makefile Add simple API docs for Qiita::ResourceBasedMethods
README.md Merge pull request #10 from increments/fix-wrong-method-name-in-readme
Rakefile Setup Rakefile for rspec
qiita.gemspec

README.md

Qiita Build Status

Qiita API v2 client library and CLI tool, written in Ruby.

Install

Note: requires Ruby 2.0.0 or higher.

gem install qiita

Library

See /doc for more details.

require "qiita"

client = Qiita::Client.new(access_token: "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd")
client.list_items
client.list_users
client.list_user_items("r7kamura")
client.get_user("r7kamura")
client.get_user("r7kamura").status
client.get_user("r7kamura").headers
client.get_user("r7kamura").body

CLI

qiita executable calls Qiita::Client's methods.

$ qiita <method> <arguments> [headers|params] [options]
           |          |          |      |         |
           |          |          |      |         `-- -H, --host
           |          |          |      |             -a, --access-token
           |          |          |      |             -c, --color
           |          |          |      |             -h, --help
           |          |          |      |                 --header
           |          |          |      |                 --no-body
           |          |          |      |                 --no-ssl-verification
           |          |          |      |             -t, --team
           |          |          |      |
           |          |          |      `------------ key=value or key:=value
           |          |          |
           |          |          `------------------- Key:value
           |          |
           |          `------------------------------ required arguments for the method
           |
           `----------------------------------------- method name

$ qiita list_users
$ qiita get_user r7kamura
$ qiita list_user_items r7kamura

Method and Arguments

Pass Qiita::Client's method name and required arguments.

Access token

Accepts access token via -a, --access-token or QIITA_ACCESS_TOKEN environment variable.

Headers

To set custom request headers, use Key:value syntax.

$ qiita list_items "Authorization:Bearer 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd"

Params

Params are used for query string in GET method, or for request body in other methods. You can set params by key=value or key:=value syntax. key=value is parsed into String value, while key:=value is parsed into JSON value (e.g. key:=17 will be {"key":17}). qiita also accepts params via STDIN.

$ qiita list_items page=2 per_page=10
$ qiita create_item < params.json

Something went wrong with that request. Please try again.