Getting To Know The Primary Use Cases of The Green Button API initiative
MyData API Patterns: OAUTH for Green Button
Please do not assume accuracy until this message is gone.
The Green Button Initiative provides for the exchange of Energy Usage Information to satisfy a number of use cases in the energy industry. The technology assembled addresses this diversity of use cases. The basic patterns of exchange are illustrated in the following figure:
Green Button technology defines three principal roles participating in a data exchange. (For Green Button, the data is energy usage information.)
- Data Custodian:the entity that is the “custodian” of the data, for example the retail electric utility. OAuth refers to this role as the “ Resource server and authorization server.”
- Third Party:the entity that wishes to provide a service to the retail customer and wants access to the data. For example, that might be a developer of advanced energy management services who is integrating cloud computing and handheld device access with consumer recommendations on how to lower a utility bill. OAuth refers to this role as the “client.”
- Retail Customer:the party whom the data is about, such as a consumer who subscribed to a local electric utility for electric service. OAuth refers to this role as the “resource owner.”
What all Green Button exchanges share in common is a basic data format for exchange. In Green Button Download My Data (GBDMD) this data is exchanged via an interaction between the retail customer and data custodian on the latter’s web Portal. The result is a file which is downloaded and can be used as the recipient sees fit.
Next in this Series
- Intro: Understanding the Green Button API Initiative and Why It Matters
- Part 1: Getting To Know The Primary Use Cases of The Green Button API initiative
- Part 2: Understanding The Requirements and Standards Behind The Green Button API Initiative
- Part 3: How Green Button Ingeniously Extended The OAuth Standard Without Forking It
- Part 4: How The Green Button API Initiative Takes Advantage of OAuth's Scope Parameter
- Part 5: How Green Button Made The "Pull-Only" OAuth Standard Support Push APIs Too
- Conclusion: How Can Other API Implementations Benefit From Green Button's OAuth Inventions?