タグ

apiに関するka2nnのブックマーク (5)

  • JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog

    3行で言うと herokuが作ってる prmd を使って、JSON SchemaからAPIドキュメントを出力したよ! スキーマ定義から、GoAPI実装コードも出力するツールを作ったらめっちゃ捗るよ! Goのバリデーション用のライブラリも作ったよ! 今回作ったものの概要とサンプルコード 概要 以前から、APIを開発する上で、以下のようなことが課題となっていました。 そもそもドキュメント書くのがつらい それもあって、ドキュメントより先にコードが変わってしまう ドキュメントと実装の状況の違いが把握しづらい また、ロジックがそんなに複雑ではないAPIでは、実装の作業は リクエストデータのバリデーション 出力データの整形 (フィルタリング) の2つの作業が大きな割合を占めます。 APIの定義ファイルからドキュメントと、バリデーションや出力データ整形のコードを自動生成できれば、大幅に効率が上がると思

    JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog
  • https://api.github.com/

    ka2nn
    ka2nn 2014/06/26
    APIのトップレベルでAPIのエンドポイントが見られるって良いね。 確かこういうのって規格があったと思うけどなんだったっけ
  • モバイルAPIデザインのまとめ - ワザノバ | wazanova

    Natasha Murashevがブログで、API Strategy and Practice Conferenceにおける、Michele Titolo (先月、「 Ruby RoguesメンバとiOSエンジニアAPI議論」で紹介しました。)とEtsyのPaul Wrightの講演のポイントをまとめてくれています。 1) スピード ユーザは待ってくれない。300msで、リクエスト / レスポンスの処理 / ユーザに結果の表示をする。 2) RESTが常にベストとは限らない 以前のEtsyのAPIリソースはDBスキーマのミラーになっていた。クライアントがリスティングのリストを受け取ったら、ユーザがFavoritedに指定しているリスティングIDを取得するために、再度APIコールする必要があった。クライアントのAPIコールが増えると、クライアントのスピードが落ちる。また障害の可能性となるポ

    ka2nn
    ka2nn 2014/04/18
    DBスキーマのミラーみたいなRESTにこだわってた時に作ったAPIのクライアントを自分で作った時に結構辛かった思い出
  • YOLPから「場所情報API」を公開しました

    ヤフー株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。LINEヤフー Tech Blog 日、Yahoo! Open Local Platform (YOLP)で、場所情報APIを公開しました。 場所情報APIは、指定された緯度経度付近の主要ランドマーク名やエリア名などを返すAPIです。「六木、東京ミッドタウン、外苑東通り」など人がコミュニケーションの中でその場所を表現する際によく使う情報を返します。 ■場所情報APIのドキュメント YOLP(地図):周辺情報取得API - Yahoo!デベロッパーネットワーク 場所情報APIの利用イメージ場所情報APIは、スマートフォンのGPS機能で取得した緯度経度情報から、「今○○付近にいます。」などと現在地をテキストで表現する際に活用できます。住所では想像しにくい場所もエリア

    YOLPから「場所情報API」を公開しました
  • API for CakePHP : The PHP Rapid Development Framework :: version 1.1.x.x

    Navigation Class Navigation × CakePHP 5.0 API Namespace Tree Global Cake Cake\Cache Cake\Cache\Engine Cake\Cache\Exception Cake\Collection Cake\Collection\Iterator Cake\Command Cake\Command\Helper Cake\Console Cake\Console\Command Cake\Console\Exception Cake\Console\TestSuite Cake\Console\TestSuite\Constraint Cake\Controller Cake\Controller\Component Cake\Controller\Exception Cake\Core Cake\Core\C

  • 1