三津石智巳

👦🏻👦🏻👧🏻 Father of 3 | 🗺️ Service Reliability Engineering Manager at Rakuten Travel | 📚 Avid Reader | 👍 Wagashi | 👍 Caffe Latte | 👍 Owarai

【感想】Practical API Design

"“APIs are like stars; once introduced, they stay with us forever.”"

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

かっこいい。

"We need to stop designing a house, and learn how to design a universe. We need to learn that “once an API star is discovered, it is going to stay with us forever.”"

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

APIデザインのためには家を設計する方法ではなく、宇宙を設計する方法を学ぶ必要がある。

"One designer is able to maintain consistency without any formal rules. However, one designer simply doesn’t scale."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

1人の設計者では簡単に規模の拡大に対応できない。

"Treat your class as an API and you’ll have many fewer headaches."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

クラスもAPIとして取り扱う。

"Some criticize them for being too complex, though my own research in 1997 implied that this could hardly be done in a better way."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

Javaジェネリックスの調査知りたい。

"The foremost questions that deserve an answer are, “Why create an API?” and, in fact, “What is an API?” This book discusses these questions in detail."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_FM_7_Preface.xhtml

なぜAPIを作成するのか、APIとは何か。かっこいい。

"One of the basic terms in the world that our discipline wants to explore is stable API."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_Part1.xhtml

stable API

"I face this kind of misinterpretation all the time, where a term from the basic API vocabulary has different meanings for different people."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_Part1.xhtml

基本的なAPIという用語が人によって異なる意味に解釈される。

"Therefore, API design is about trust: by following the best practices I describe, you can maximize the probability that you will be able to avoid backward-incompatible changes, and thus earn and maintain that trust."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_2_Chapter.xhtml

API設計とは、信頼に関する活動。

これまで経営してわかったことは、企業が顧客の信頼を得るには、わかりやすくて、安くて、便利なよい商品・サービスを提供し続けることがまず第1だ。

See More: http://lnr.li/vwIqY

同じようなこと。API as a product。

"Once again, let’s remind ourselves why we’re interested in the development of APIs: we want to cluelessly assemble our applications from large building blocks, such as shared libraries, frameworks, premade application skeletons, as well as combinations of these."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_3_Chapter.xhtml

API開発とは、レゴブロックの組み合わせでアプリケーションを作成したいという価値観のこと。

"APIs exist to shield us from a component’s internals. They exist to allow us to be clueless yet still able to build our applications using the black-box building blocks."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_3_Chapter.xhtml

APIは、私達を無知にしてくれると同時にブラックボックスのビルディングブロックを使用してアプリケーションの構築を可能にする。

"How to Check the Quality of an API"

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_3_Chapter.xhtml

comprehensibility, consistentency, discoverability, Simple Tasks Should Be Easy, Preservation of Investment

"Every API writer needs to have an evolution plan; that is, to know on a strategic level what will happen to the API in future releases."

 

via Check out this quote from Practical API Design - https://learning.oreilly.com/library/view/practical-api-design/9781430209737/9781430209737_4_Chapter.xhtml

すべてのAPI作成者は、発展計画を立てる必要がある。