Automatic API Document Generation From SCIM Metadata

Fecha de publicación: 27/08/2020
Fuente: WIPO "apis"
Embodiments provide automatic representational state transfer application programming interface (“REST API”) document generation for System for Cross-domain Identity Management (“SCIM”) based resources. For each resource, embodiments identify all SCIM based resource type data files and corresponding schema, where each resource type data file includes resource type definition metadata. Embodiments identify available operations based on the resource type definition metadata and apply HyperText Markup Language (“HTML”) operations corresponding to the metadata based on an available Swagger Operation template engine. Embodiments convert SCIM based schema to Swagger schemas by iterating through each available schema and identifying attributes and preparing a Swagger attribute template engine to generate a Swagger based attribute definition to a Swagger template aggregator. Embodiments then generate Swagger JavaScript Object Notation (“JSON”) corresponding to the Swagger schemas.