[B! api][json] Makotsのブックマーク

現実世界におけるスキーマ設計の妥協

存在感が薄い?!意外とがんばってるさくらインターネットFEチーム / Frontend Conference 2024

Makots 2023/04/26

リンク

mozaic.fm #7 RESTや#mozaicfm REST を聴いての感想、それから「Web+DB vol82のWebAPIデザインの鉄則」に触発されたので書こうと思う。 REST設計について WebAPIを設計するうえでRESTが重要であることは周知のとおりである。 “Constraints are liberating”「制約は自由をもたらす」 @t_wadaさんがおっしゃっているように、RESTを前提にすれば、「アーキテクチャとしてもそうだし、アプリケーションフレームワークも「適切な制約」を設けることで設計のコストが下がる」という大きなメリットが生まれる。しかし、相変わらずリソース設計やらインターフェース設計やらで悩んでおられる方も多いと聞く。その一方で個人的には適切なフレームワークを使えばREST設計で悩まなくてもよいはず(※3)という思いもある。インターフェース設計な

Makots 2014/08/28

リンク

全てがJSONになる - ✘╹◡╹✘

TL;DR JSON Schemaを使ってこういうことが実現可能になった。ダミーAPIサーバの提供ドキュメントの自動生成 APIクライアントの動的定義 APIサーバのバリデータの動的定義 APIサーバのレスポンスの自動テスト JSON Schemaとは JSON SchemaというのはあるJSONのデータ構造を記述するための方法および書式の仕様で、 JSON SchemaもJSONで記述される。これを利用すれば、リソースベースの(=RESTfulライクな)APIの仕様が簡便に記述できる。例えば、我々のAPIはレシピとユーザというリソースを扱っていて、それぞれCRUDのAPIを備えており、レシピはidとtitleとdescriptionという属性を持つ、という旨をJSON Schemaで表現できる。なんで最近ちょっと流行ってんの Mobile First、 Service Or

Makots 2014/06/10

リンク

体育の日って高速に唱えるとテストの日に聴こえる - ✘╹◡╹✘

テスト書きすぎ問題 - hitode909の日記階層が増えるとテストが増える - はこべブログ ♨ テストと対応関係 - $shibayu36->blog; 最近書いているWebアプリは、HTTPリクエストを送ってレスポンスと状態をテストする、というテストだけ書くようにしてる。リクエストするとブログエントリを返す、というサービスだとこういう風なテストを書いてる。(HTMLを返すようにすると話が広がって説明が面倒なのでJSONを返すAPIで説明する) describe "Entry resource" do let(:params) do {} end let(:env) do { "HTTP_AUTHORIZATION" => "Bearer: #{access_token.token}" } end let(:access_token) do AccessToken.make(user

Makots 2013/10/15

リンク

JSON on HTTPやWeb APIを各言語でどうやって実装するのか

HTTPでアクセスして、JSONを返すようなWebサーバを書きたいとする。どんな言語を選ぶか。どんなミドルウェアを選ぶか。どんなライブラリを選ぶか。たとえば、TIOBE Softwareが公表している「Programming Community Index(PCI)」という指標がある。人気のあるプログラミング言語の数値化。これを見ていて思ったのは、「多すぎだよね、プログラミング言語」ということ。これらのうち、どの言語を勉強し、どの言語をプロジェクトに採用すべきなのか。その感触を得るために、「同じ仕様のREST serviceを複数言語で実装したらいいんじゃね？」と思った。いくつかの言語で実装を起こしてみている。前提条件大規模な開発を想定する。ユーザの規模が大規模。トランザクション数が大規模。そして、開発者が大規模。実用的かつモダンな開発を想定する。プロジェクト毎のバージョン

Makots 2012/03/26

リンク

SQLとJSONをNode.js上で組み合わせた新言語「ql.io」をeBayが公開

eBayが、JavaScriptアプリケーションからSQL文のような形式でデータベースへの問い合わせを記述できるDSL（ドメイン固有言語）のql.ioを発表。オープンソースとして公開しました。現在、多くのWebアプリケーションが、バックエンドとのデータのやりとりにHTTPをベースにしたAPIを用いています。しかし、WebベースのAPIによってデータを取り出すのは、プログラマにとって実は手間のかかることです。例えば、キーワードを入力すると関連する商品の名前、詳細、購入者の評価をユーザーに表示する、というWebアプリケーションでは、まずキーワードでデータベースを検索して商品IDを取得し、今度はその商品IDをキーにして名前や概要、評価の情報を取得する、といったように、APIを繰り返し呼び出す必要があります。 ql.ioはこうした内容をSQLのように分かりやすい記述で実現するだけでなく、複数の

Makots 2011/12/03

リンク

新はてなブックマーク件数取得 API を使って自分のページに件数を埋め込む最も簡単な方法 - IT戦記

はてなブックマークから新しい件数取得 API が提供されているようです！ (開発者さま向け)はてなブックマーク件数取得APIに新しいAPIを追加 - はてなブックマーク日記 - 機能変更、お知らせなどこの API のいいところは JSONP に対応しているところでしょうね！すばらしい！というわけで、 HTML だけで、件数を埋め込む例を書いてみたよ！やり方は簡単 callback パラメータに document.write を指定するだけ！ <script src="http://api.b.st-hatena.com/entry.count?url=http%3A%2F%2Fwww.example.com%2F&callback=document.write"></script>件のブックマークがあります。あとは、適当にリンクとか張って <a href="http://b.ha

Makots 2009/08/11

リンク

【YQL 速攻レビュー】米 Yahoo! が SQL っぽく色んなデータを取ってこれるAPIを出した - てっく煮ブログ

米 Yahoo! が Yahoo! Pipes みたいに自由度が高くて、またちょっと毛色が違うサービスが出てきた。題して、Yahoo! Query Language。YQL と呼ぶようだ。SQL 風の言語を REST で投げて、結果を XML や JSON で受け取ることができる。具体的にやってみないと分かりにくいので、とりあえず試してみた。RSS からデータ取得YQL を使って RSS から最新のタイトル10個を取ってきてみる。こんな YQL になるらしい。 select title from rss where url='http://d.hatena.ne.jp/nitoyon/rss' rss テーブルに対して select を発行している。実際にこの YQL を試すには YQL 用の console を利用するとよい。（※要ログイン）console の左上に YQL を入力して

Makots 2008/12/15

リンク

twitter検索

Twitter全文検索 &jsonってつけるとJSONで返します。 &rssってつけるとRSSで返します。 100件ずつ100ページまでです。 ※ヒット数が多すぎる語は検索しません。 Twitter検索微妙にバグってて本文が部分的に落ちてたりするんですがちゃんと調べてないです。何か分かったら教えてください。 2008年11月9日あたりから回収始めました。JSONとRSS(Atom)を吐きます。回数制限など考えるのも面倒。興味をもたれた方は常識的な範囲で使ってください。 2008年11月10日更新