scope:

The scope of the present document is to present a methodology for specification and testing of RESTful APIs, i.e. telecommunication interfaces based on the Representational State Transfer paradigm, suitable for application in the standardization context.

In particular, the present guide is meant to serve ETSI membership and groups in the effort to unify and consolidate the approaches and practices in current and future standardization activities at ETSI and its Partnership Projects.

The Guide collects the best practices from standardization, industry and research in order to provide a modern and future-proofed approach to the subject.

The intended audience is primarily standardization groups at ETSI, but the guide may also serve as reference for users and vendors in industry, with a special focus in Open Source communities.

The Guide recommendations on conventions, methodologies, design-patterns and architectural choices to be used in standardization of RESTful APIs, specification and execution of standardized conformance and interoperability test suites.