Method generateOpenAPISpec

runtime/server/api.go:181–244

(ctx context.Context, instanceID string, apis map[string]*runtimev1.API)

}

func (s *Server) generateOpenAPISpec(ctx context.Context, instanceID string, apis map[string]*runtimev1.API) (*openapi3.T, error) {
	attributes := s.runtime.GetInstanceAttributes(ctx, instanceID)
	var organization, project string
	for _, attr := range attributes {
		if attr.Key == "organization" {
			organization = attr.Value.AsString()
		} else if attr.Key == "project" {
			project = attr.Value.AsString()
		}
	}
	var title string
	if organization != "" && project != "" {
		title = fmt.Sprintf("Rill %s/%s project API", organization, project)
	} else {
		title = "Rill project API"
	}

	spec := &openapi3.T{
		OpenAPI: "3.0.3",
		Info: &openapi3.Info{
			Title:   title,
			Version: "1.0.0",
		},
		Paths: &openapi3.Paths{},
	}

	var runtimeHost string
	if s.opts.AuthAudienceURL != "" {
		runtimeURL, err := url.Parse(s.opts.AuthAudienceURL)
		if err != nil {
			return nil, err
		}
		runtimeHost = runtimeURL.Host
	} else {
		runtimeHost = fmt.Sprintf("localhost:%d", s.opts.HTTPPort)
	}

	spec.Servers = openapi3.Servers{
		&openapi3.Server{
			URL: fmt.Sprintf("http://%s/v1/instances/%s/api", runtimeHost, instanceID),
		},
	}

	for name, api := range apis {
		pathItem, componentsForPath, err := s.generatePathItemSpec(name, api)
		if err != nil {
			return nil, err
		}

		spec.Paths.Set(fmt.Sprintf("/%s", name), pathItem)

		for k, v := range componentsForPath {
			if spec.Components == nil {
				spec.Components = &openapi3.Components{}
			}
			if spec.Components.Schemas == nil {
				spec.Components.Schemas = make(map[string]*openapi3.SchemaRef)
			}