API

API設計について学べる本

アプリケーション

最近API設計について学び直そうと思って数冊ピックアップして読書したので、読んだ本をリストアップしておく。 API設計の本リスト おすすめの読書順でリストアップする。 Web API: The Good Parts 一般的なAPIの設計における基本的な考え方を学ぶことができる API設計本におけるリーダブルコードのような教科書的立ち位置の本(だと感じている) Web APIの設計 Web A...

API 設計

APIデザイン・パターン

アプリケーション

APIデザイン・パターンを読んだ。  APIの設計原則に始まり、豊富なAPIのデザイン・パターンを紹介している。 リソース指向 単一のリソースに対して、標準メソッド(ex, Create/Get/List/Delete/Update)をかけ合わせて処理を決める RPC指向 メソッドを指定して特定の手続きを呼び出して処理を決める API設計を良くするため観点 実行可能であること 表現力があ...

API 設計

Web APIの設計

アプリケーション

Web APIの設計を読んだ。 API設計の視点を与えてくれる本。 API設計のインターフェースだけでなく、もっと手前の入り口から書かれている。 API設計は、仕組みではなくユーザーが何をできるかに焦点を当てて設計すると良い。仕組みに焦点を当てると複雑化する APIのゴールを洗いだすアプローチとしてゴールキャンパスというフレームワークの解説があったが、良い方法だと思った APIバージョニングのパ...

API OpenAPI 設計

Web APIテスト技法

アプリケーション

Web APIテスト技法を読んだ。 API設計のテストで5w1hを使って問いを考える話があったが、具体例が分かりやすく、示唆に富んでいた 現場のテスタビリティについて理解するフレームワークとして挙げられていた10個のPモデルが良かった。テスト戦略や計画を考える前提の整理に役立ちそう テスト計画の整備と文書化について書かれているテスト計画のフォーマット例も考えやすいシンプルなもので良かった。戦略と...

API

GraphQLとは

アプリケーション

GraphQLとは Facebookが開発 APIのためのクエリ言語 APIのリクエストのデータ形式とレスポンスのデータ形式が似ているため、ユーザーフレンドリー RESTはアーキテクチャ(設計)であり、GraphQLは言語(DSL)である REST APIとGraphQLの比較REST APIのAPI形式エンドポイントに対して、HTTP動詞でリクエストを投げる curl https://ap...

API HTTP REST GraphQL

LaravelでRestAPIをつくる

アプリケーション

LaravelでReactをフロントエンドのフレームワークとして採用しているのですが、APIを設計する必要がでてきたのでやってみました。 やること ResourceControllerをつくってデータを出力するだけのAPIをつくる API公開を見越した認証用ミドルウェアを実装する やらないこと Restの説明 APIデータの更新や削除 Ajaxでのデータの取得と出力 環境 Laravel5.2...

API Laravel React REST

bitflyerのprivate apiを使ってビットコイン資産状況をslackに通知する

アプリケーション

背景bitflyerが用意しているAPIをちょっと使ってみたかったので資産状況を返すAPIをたたいてみました。 ソースnodejsでAPIをたたきます。レスポンスデータは恥ずかしいので見せません。//// なおソースコードの大部分はドキュメントの例を参考にしています() var request = require('request'); var crypto = require('crypto')...

API bitcoin Node.js bitflyer

bitflyerのprivate apiを使ってビットコイン資産状況をslackに通知する Part2

アプリケーション

前回、bitflyerのAPIを叩くだけ叩いてポイーしてたので、今回はレスポンスデータを整形して資産情報データとしてslackに投げれるようにします。 とりあえずasyncで非同期処理APIを複数叩く必要があったのでasyncを使いました。エラー拾っているところは参考サイト(失念しました)を真似ています。なんだか見通しの悪いコードになってしまいました・・・ var request = requir...

bitflyer API async bitcoin Node.js

Web API: The Good Parts

アプリケーション

Web API: The Good Partsを読んだ。 APIの設計方針について学ぶにはまず読んでおきたい本。 API設計の基礎的内容が書かれている。設計に迷ったときに読み返したくなる。 ...

API 設計