Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Focusing on API Definitions, Schemas, Scopes, and Specifications

DZone's Guide to

Focusing on API Definitions, Schemas, Scopes, and Specifications

Defining, employing, discussing, and sharing in these areas is how the API space will scale and meet the needs of specific industries.

· Integration Zone
Free Resource

Modernize your application architectures with microservices and APIs with best practices from this free virtual summit series. Brought to you in partnership with CA Technologies.

The API universe is rapidly expanding as more companies, organizations, institutions, and government agencies are sharing data, content, and algorithms using web APIs. It has expanded so much in the last year that I can't keep up with everything that is going on. I can't test new APIs, and the emerging services and tooling from providers who are targeting the space fast enough. That's OK. I'm not sweating it. 

However, I do have to prioritize and focus on the areas where I can make the biggest impact when it comes to my understanding and when it comes to helping the API community. While I will still be maintaining a general awareness of all technologies, in 2017, I'm going to be heavily focused on these areas:

  • API definition. The machine-readable definition of an API interface, security, and data models.
  • Data schema. A JSON schema, MSON, or other machine-readable description of data schema.
  • OAuth scope. Shared definitions of OAuth scopes in play for an API and its resources.
  • Web specifications. Web concepts and specifications that make the web go 'round.

Code plays a significant role, and specific implementations are important, but for me, these four areas represent the core of the API space. Defining, employing, discussing, and sharing in these areas is how the API space will scale and meet the needs of specific industries. Investing in these areas will make the API sector healthier and stronger, and make an impact when it comes to combatting much of the focus on investment and proprietary of technology that works against things being truly interoperable reusable.

In 2017, I'm focusing the majority of my work in these areas. These are not the areas where the money will be in the future, but it will be what enables all the areas that do make startups money and make a difference on the ground at small businesses and the enterprise. Investment in common definitions, schema, scopes, and specifications will be the second challenge for the API sector in coming years — right after security. I'm not sure what I can do on the security front, but I know I can make an impact when it comes to helping define common patterns of the API universe.

The Integration Zone is proudly sponsored by CA Technologies. Learn from expert microservices and API presentations at the Modernizing Application Architectures Virtual Summit Series.

Topics:
api ,api definitions ,schemas ,oauth ,scope ,web specifications

Published at DZone with permission of Kin Lane, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}