API versioning independent of product releases
Technologies for a contract platform versioned according to the set of API contracts provided. API contracts are both development-time and run-time executable components. Each such contract defines a particular set of APIs that are fully supported at run-time by a corresponding implementation module. Contract applications are written to API contracts as opposed to the monolithic APIs of a legacy platform. Such applications are “platform agnostic”.
1. A method performed on a computing device that includes at least processor and memory, the method for programmatically providing a feature to a contract application via an application programming interface (“API”) contract, the method comprising: hosting, by the computing device, the API contract that is configured for programmatically providing the feature to the application, where the API contract comprises identification information for the API contract, version information for the API contract and the feature, definition information that defines aspects of the feature, and executable code configured for responding to queries about the API contract.
2. The method of claim 1 where the API contract is discoverable at run-time.
3. The method of claim 1 where the API contract is associated with a corresponding executable module that implements at least a portion of the feature.
4. The method of claim 1 where a type defined by the API contract includes a type version attribute that indicates a version of the API contract at which the type was added to the API contract.
5. The method of claim 1 where the version information includes a current version of the API contract.
6. The method of claim 5 where the current version is equal to or greater than all versions indicated by any type version attributes included in the definition information.
7. The method of claim 1 where any types defined in the definition information are immutable or additively versioned.
8. A system comprising a computing device and at least one program module that are together configured for performing actions for programmatically providing a feature to a contract application via an application programming interface (“API”) contract, the computing device including at least one processor and memory, the actions comprising: hosting, by the computing device, the API contract that is configured for programmatically providing the feature to the contract application, where the API contract comprises identification information for the API contract, version information for the API contract and the feature, definition information that defines aspects of the feature, and executable code configured for responding to queries about the API contract.
9. The system of claim 8 where the API contract is discoverable at run-time.
10. The system of claim 8 where the API contract is associated with a corresponding executable module that implements at least a portion of the feature.
11. The system of claim 8 where a type defined by the API contract includes a type version attribute that indicates a version of the API contract at which the type was added to the API contract.
12. The system of claim 8 where the version information includes a current version of the API contract.
13. The system of claim 12 where the current version is equal to or greater than all versions indicated by any type version attributes included in the definition information.
14. The system of claim 8 where any types defined in the definition information are immutable or additively versioned.
15. At least one computer-readable medium storing computer-executable instructions that, when executed by at least one processor of a computing device, cause the computing device to perform actions programmatically providing a feature to a contract application via an application programming interface (“API”) contract, the computing device including at least one memory, the actions comprising: hosting, by the computing device, the API contract that is configured for programmatically providing the feature to the application, where the API contract comprises identification information for the API contract, version information for the API contract and the feature, definition information that defines aspects of the feature, and executable code configured for responding to queries about the API contract.
16. The at least one computer-readable medium of claim 15 where the API contract is discoverable at development-time the API contract is implied or indicated by source code.
17. The at least one computer-readable medium of claim 15 where the API contract is associated with a corresponding executable module that implements at least a portion of the feature.
18. The at least one computer-readable medium of claim 15 where a type defined by the API contract includes a type version attribute that indicates a version of the API contract at which the type was added to the API contract.
19. The at least one computer-readable medium of claim 15 where the version information includes a current version of the API contract that is equal to or greater than all versions indicated by any type version attributes included in the definition information.
20. The at least one computer-readable medium of claim 15 where any types defined in the definition information are immutable or additively versioned.
21. A method performed on a computing device that includes at least one processor and memory, the method for programmatically providing features of a contract platform to a contract application via at least one set of application programming interface (“API”) contracts, the method comprising: hosting, by the computing device, the at least one set of API contracts that are each configured for programmatically providing one of the features to the contract application, where the each API contract comprises identification information for the each API contract, version information for the each API contract and its provided feature, definition information that defines aspects of its provided feature, and executable code configured for responding to queries about the each API contract.
22. A method performed on a computing device that includes at least one processor and memory, the method for programmatically accessing, by a contract application, a feature provided via an application programming interface (“API”) contract, the method comprising: executing, by the computing device, the contract application that is configured for programmatically accessing, via the API contract, the feature, identification information of the API contract, version information of the API contract and the feature, definition information that defines aspects of the feature, and executable code configured for responding to queries about the API contract.
23. A method performed on a computing device that includes at least one processor and memory, the method for programmatically accessing, by tooling of a development environment, a feature provided via an application programming interface (“API”) contract, the method comprising: executing, by the computing device, the tooling that is configured for programmatically accessing, via the API contract, the feature, identification information of the API contract, version information of the API contract and the feature, definition information that defines aspects of the feature, and executable code configured for responding to queries about the API contract.