Qiita API v2のJSON Schemaを公開しました - Qiita Blog
こんにちは、r7kamura です。 最近は主にイカとして活動しており、カラフルな墨を掛け合う日々を送っています。 さて、QiitaおよびQiita Teamでは、Qiita API v2としてデータを操作するためのREST APIを公開しています。これまで開発者向けに APIドキュメント を提供していましたが、今回は主に機械向けのインターフェースとして、JSON Schemaで記述したREST APIのスキーマ定義 (以下スキーマ) を公開することになりました。具体的には、JSON Hyper-Schema draft v4 を利用して定義されています。 http://qiita.com/api/v2/schema Qiita API v2のスキーマの説明Qiita API v2のスキーマの構成について簡単に説明します。スキーマは http://qiita.com/api/v2/sche
僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳
2023 追記 2023 年現在では、以下の文章では採用を見送っている OpenAPI を使えば OK という雰囲気です。 Web APIの設計 作者:Arnaud Lauret翔泳社Amazon TL; DR ドキュメント生成にはkevinrenskers/raml2htmlを使った ドキュメントはRAML - RESTful API modeling languageで書いた RAMLにはJSON SchemaとJSONを記載できる APIで返ってくるJSONはRailsアプリのrequest specでJSON Schemaを使ってテストした JSON Schemaはr7kamura/json_worldで生成した ドキュメントに載せる例示のJSONもJSON Schemaからgin0606/screijiを使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
Parseサービス終了についての雑感
BaaS(Backend as a Service)のParseが、来年一月でサービスを終了することをブログでアナウンスしました。昨年末にウェブ・ダッシュボードをReactベースで刷新するなど、活発に開発がされている印象があったので、とても驚きました。Twitterのタイムラインでは、デベロッパーさんのこんなつぶやきも。 筆者自身も現在開発中のゲーム・アプリでParseの一部機能を利用しており、以前にも自分の関わるウェブ・サイトでParseの利用を検討していたことがあったので、Twitterにいくつか感想を書きました。せっかくなのでここに記事としてまとめておきます。 Parseの移行に関する情報先に書いておくと、既存の顧客にはデータをMongoDB形式でエクスポートするツールと、Parse互換のAPIサーバがオープンソースで提供されます。ただし、現状ではAPIサーバはウェブ・ダッシュボード
GitHub API v3 | GitHub Developer Guide
Delivering deploymentsUsing the Deployments REST API, you can build custom tooling that interacts with your server and a third-party app. Using the REST API to interact with checksYou can use the REST API to build GitHub Apps that run powerful checks against code changes in a repository. You can create apps that perform continuous integration, code linting, or code scanning services and provide de
Web APIにはJSONベースのフォーマットを使おう - Qiita
{ "response": { "id": 3342124, "message": "Hi!", "user": { "id": 3456, "name": "Taro Yamada", "image_url": "/images/taro.png" } } } など、どの構造がいいでしょうか？ もっと違う構造も考えられます。 JSONはシンプルですが、構造に制約がなさすぎます。適切な設計を行うには適切な制約が必要です。 そこで、plain JSONに少し制約を加えたJSONベースのフォーマットを使うことをおすすめします。 もしあなたが、JSONレスポンスをどのようなフォーマットにするかをチームで議論したことがあるなら、JSON APIは『自転車置き場の議論』に対抗する武器となる。 共有された規約に従うことで、生産性が向上し、汎用的なツールを利用でき、アプリケーションという重要なものに集中
読み取り専用APIキーと新しいAPIを使った安心で便利なサーバ管理 - Mackerel お知らせ #mackerelio
MackerelではAPIを使っていろいろな機能を実現することができます。 本記事ではより便利になったMackerelのAPIの活用事例を紹介します。 MackerelのAPIについて MackerelではAPIを使用して、各種の情報の取得や更新が出来ます。 例えば管理しているホストの一覧はcurlを使って以下のように取得できます。 $ curl -H "X-Api-Key: <YOUR_API_KEY>" https://mackerel.io/api/v0/hosts.json レスポンスはJSONで返ってくるため、各言語のJSONライブラリを使ってパースしたり、jqなどのツールで必要な情報を取り出すことが出来ます。 詳しくはAPI仕様をご覧ください。 help-ja.mackerel.io 安全に使用できる読み取り専用APIキーの登場 MackerelのAPIはオーガニゼーション毎に
Nearby | Google for Developers
Discover and establish direct communication channels with other devices without having to be connected to the Internet. Enables seamless nearby interactions such as multiplayer gaming, realtime collaboration, forming a group, broadcasting a resource, or sharing content. The Nearby Connections API is available for Android and iOS, and enables communication between the two platforms.
グーグル、近接通信API「Nearby」を公開--「iOS」と「Android」向け
自分の近くにいて同じアプリを使っている人を探すのが、これまでよりもはるかに簡単になりそうだ。Googleは米国時間7月14日、近接通信を支援する「iOS」および「Android」アプリ向けのAPI「Nearby」をリリースした。 Nearbyを有効にしたアプリは、Bluetooth、Wi-Fi、そして人間の耳には聞こえない音を使って、複数ユーザーとアプリの間でデータを見つけ、共有できるようになる。 Googleは、すでにNearbyの前身となるものを同社の「Chromecast」の「ゲストモード」に採用し、「Google Play Games」内で互いに近くにいるプレイヤーたちのペアリングに使っていた。同社は今回、このAPIをサードパーティーの開発者らに公開し、2つの主要モバイルプラットフォーム向けのアプリに組み込めるようにした。 このAPIについて発表したブログで、Googleはいくつか
Go言語で API サーバーを開発する | カメリオ開発者ブログ
こんにちは！白ヤギの開発者、森本です。 白ヤギではいま API サーバーを Go 言語で開発しています。 皆さんも Go の話題をよく見聞きするようになっていると思います。今回は白ヤギの業務でどんな風に Go を使って開発しているかの一端を紹介します。 余談ですが、先日、大学の先生とお話ししたときにこんな話を伺いました。その先生は学生にプログラミングを教えているそうですが、何割かの学生は及第点に届かないそうです。しかし、そういった学生がプログラミングの素養がないかというとそういう訳ではなく、プログラミングを学ぶ上でその学生にとって何が理解を促すのかが違うだけなのだと仰っていました。教える側として全ての学生が習得できるプログラミング教育というのを見つけられていないのが悔しいといった話をされていました。 何かを学ぶというのを一般論では語るのは難しいということかもしれません。そのため、私はこうい
json-schemaからSwiftのAPIクライアントを自動生成するツールを作った - Less is Best
はい、最近なにかと流行っている?json-schema界隈、いかがお過ごしでしょうか。 json-schemaからSwift, Java(未実装)のAPIクライアントを自動生成するツールAriesを作りました。 github.com 機能についてはもう言うこと無いですね。JSONSchemaからSwiftのAPIClientを生成するジェネレータです。Promiseライクに操作したかったので ReactKit/SwiftTask · GitHubを採用。Networking libraryとしてAlamofireを使っています。 なぜ作った アプリの開発を行うとなったら、今はiOS, Andriodどっちも作るのが当たり前ですよね! どうしたら楽して手っ取り早くクロスフォームでアプリを開発できるのかと、調査を重ねてました。 Xamarin => かなり良さげだけど高い、、お高い+c#知らん
APIフレームワークGrapeをRuby on Railsの中で動かすと遅いぞ - yuumi3のお仕事日記
ある仕事でスマフォ用のAPIサーバーを作る事になり、REST-like APIが簡単に作れるフレームワーク grape を調査してみました。grapeの良さは、DSLで簡単にAPIサーバーが書ける点とRackで動く軽いフレームワークなのでRuby on Railsに比べ高いパフォーマンスが期待できる点です。 システム構成 Grapeは Mounting に書かれているようにいくつかの構成で動かせます Rack: Rack上で動かす ActiveRecord without Rails: Rackの上で動かすけど ActiveRecord を使う Rails: Ruby on Railsの中で動かす ... 今回のシステムでは管理者用のWebアプリは Ruby on Railsで作るので、モデルを共有できるRuby on Railsに組み込み使うのが魅力的です。 評価用コードを作ってみた 準
RailsでAPI作成とAPIのテストのまとめ - Rails Webook
Photo by Gonzalo Baeza | Flickr - Photo Sharing! RailsでJSONを返すAPIを作成し、また、APIのテスト方法も説明します。 JSONを返すAPIは、RailsのActiveSupportより拡張されたto_jsonメソッドとDMMが開発したjbuilderというGemを使います。 APIのテストにはおなじみのRSpec3を使います。 動作確認 Rails 4.1.7 jbuilder 2.2.6 rspec-rails 3.1.0 factory_girl 4.5.0 目次 1. 前提条件 2. APIの作成 2.1. 1つのコントローラーでHTMLやJSONを返すAPI 2.2. JSONのみを返すAPI 2.3. APIのバージョニング 3. APIのテスト 3.1. テストファイルの準備 3.2. 一覧(index)APIのテス
ZapierでSlackを佐野ひなこちゃんで埋め尽くす #apijp - @i2key のBlog
本ポストは下記のアドベントカレンダー13日の記事になります。 Web API Advent Calendar 2014 - Adventar ところでみなさん、Zapierってご存知でしょうか？ The best apps. Better together. - Zapier 一部界隈では便利ツールとして凄く有名ですが、ご存知ではないかたのために簡単に説明いたします。 APIとAPIをコーディング無しで連携させることが出来るハブサービスになります。 Yahoo PipesとかIFTTTのようなイメージです。 ただ、連携可能なサービスがものすごく多く、300以上あります。SlackやTwitter、Instagram、Facebook、JIRA、Trello等有名どころは大抵連携できます。 Twitterでファボッたツイートを自動的にインスタペーパーに登録したりとか、そういう連携です。 あと
Rails API Testing Best Practices · Matthew Lehner
Something went wrong! Hang in there while we get back on track Writing an API is almost a given with modern web applications. I’d like to lay out some simple guidelines and best practises for Rails API testing. We need to determine what to test and why it should be tested. Once we’ve established what we will be writing tests for, we will set up RSpec to do this quickly and easily. Basically we’ll
RESTful Web API 開発をささえる Garage - クックパッド開発者ブログ
技術部の小野(@taiki45)です。この記事では簡単なアプリケーション(ブログシステム)の実装を通して、クックパッドで作成・使用しているライブラリのGarage の紹介と Garage を使った RESTful Web API の開発をご紹介したいと思います。 Garage は RESTful Web API を開発するための、 Rails gemified plugins です。Rails プログラマは Garage を使って Rails を拡張することで素早く Web API を開発することができます。Garage は新しくアプリケーションを開発する場合にも、既存の Rails アプリケーションに組み込んで Web API を実装する場合でも使用できます。Garage はリソースのシリアライズやアクセスコントロールなど Web API の実装に必要な機能をカバーしています。 Ruby
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Mobile info
Web API サーバーとしての Elixir の可能性
TechCrunch
API Console | Tumblr
https://performance-partners.apple.com/resources/documentation/itunes-store-web-service-search-api.html