タグ

apiとAPI設計に関するtama_1028のブックマーク (2)

  • API開発フローと設計について語る - Qiita

    K.S.ロジャース株式会社の民輪です。超久しぶりにQiita復帰してみました。以前の投稿が2年前。しかも超適当に記事を書いたせいでツッコミ入ったなーという記憶。ちなみに最近はJS方面にリソースさきつつ、WebGLやらないといけないのでThree.jsに手を出そうとしています。 一応これでも曲がりなりにもCTOもどきをやっているわけで真面目に記事書こうと一念発起しました(すぐに折れるかもしれない)。CTOとしてAPIの開発のマネジメントとかよくあるわけで、他の人とかに聞いてると案外グダッてる現場とかあるんだなぁと思いこの記事を書こうと思いました。 tl;dr APIの開発は必ずドキュメントを作成して、ドキュメントのモックを真とする。 APIのドキュメントはエクセルなどではなく、弊社はApiaryを使っている(swaggerでもいいとは思う) APIの仕様を変更する場合にはドキュメントの変更ま

    API開発フローと設計について語る - Qiita
  • 5分で絶対に分かるAPI設計の考え方とポイント

    API設計を学ぶべき背景と前提知識、外部APIと内部API、エンドポイント、レスポンスデータの設計やHTTPリクエストを送る際のポイントについて解説する。おまけでAPIドキュメント作成ツール4選も。 【0分】API設計を学ぶべき背景 APIの公開が増えている 最近、自社で保有するデータや、システム、アプリケーション、Webサービスの機能を「API(Application Programming Interface)」として公開する企業が、増えてきています。これに伴い、「API経済圏(APIエコノミー)」という新たなビジネスモデルが確立されつつあります(参考:5分で絶対に分かるAPIマネジメント、API経済圏)。 「ProgrammableWeb」というAPIに関するニュースサイトや、さまざまな企業が提供するAPIのリンクがまとまったサイトもあり、APIの普及はものすごいスピードで進んでいる

    5分で絶対に分かるAPI設計の考え方とポイント
  • 1