All notes
Api

Concepts

Richardson Maturity Model

martinFowler.com: RMM.

  1. Level 0: The swamp of POX (plain old xml).
  2. Level 1: Resources.
  3. Level 2: HTTP verbs.
  4. Level 3: Hypermedia controls. HATEOAS (Hypertext As The Engine Of Application State).

Good API desing:

snapshot
delta

Conformance order:
IETF > ISO > OASIS > Community.

Date: ISO 8601. wikipedia: ISO 8601.

Combined date and time in UTC:
2017-05-03T14:07:04+00:00
2017-05-03T14:07:04Z
20170503T140704Z

Apigee

apigee is an API proxy providing security, compatibility, measurability and monetization services for backends.

API.AI

api.ai provides AI to api's and you can even train it with logs.