An API Terms of Service API
An API Terms of Service API
An API expert takes a look at an API that delivers terms of service for, well, APIs. You'd be surprised how few of these types of APIs are out there! Read on for details.
Join the DZone community and get the full member experience.Join For Free
The State of API Integration 2018: Get Cloud Elements’ report for the most comprehensive breakdown of the API integration industry’s past, present, and future.
I’ve been tracking on the terms of service for APIs for eight years, but I haven’t ever come across a terms of service API. I found one the other day while looking through the Box API, and thought it was worth showcasing as part of my research. The Box terms of service API, “allows Box Admins to configure ToS and end users to accept/re-accept ToS for custom applications.” The Box terms of service API represents the association between Terms of Services and users, providing several different configurations:
- There is exactly one Terms of Service User Status for a given Terms of Service and a given user.
- There are multiple Terms of Service User Statuses for a given Terms of Service (e.g. one per each user).
- There could be multiple Terms of Service User Statuses for a given user. The user could accept/reject multiple external ToS for enterprises they have been collaborated into in addition to accepting/rejecting their own enterprise’s managed ToS.
The Box terms of service API allows for managing multiple terms of service, and multiple users engagement with those terms of service. Providing eight separate API endpoints for managing each individual terms of service, and the users' agreement to them. I’d like to see a more modular approach to managing the components of each terms of service, as it applies to APIs. Allowing for more reusable terms of service modules that can be reused across many different APIs. I’m thinking beyond just documents and their applications, I am thinking about widely applied across APIs and any application that can be built on them.
I’m going to add Box’s terms of service API definition to my research and use it as a base for other potential use cases. It is one of those areas I feel needs some investment, to help make this layer of API operations more observable. Every building block of the API platform should have an API in my opinion, especially the terms of service layer. It is an API pattern I’d like to see exist in the API space and is an API definition I’ll add to help make more applicable, and forkable so that API providers can implement their own terms of service API.
Published at DZone with permission of Kin Lane , DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.