a minimal smartAPI description

myapi-smartapi.yaml

openapi: 3.0.0
info:
  title: my.sparql.api
  version: 0.1.0
  description: my awesome sparql API
  termsOfService: http://github.com/jane.doe/tos
  contact:
    name: jane doe
    x-id: http://github.com/jane.doe
    x-role: responsible developer
x-externalResources:
  - x-url: http://github.com/jane.doe/myapi
    x-type: api documentation
    x-description: github repo for API
servers:
  - url: http://janedoe.info/myapi

paths:
  /sparql:
    get:
      summary: SPARQL endpoint
      description: SPARQL query path
      tags: 
       - SPARQL
      responses:
        '200':
          description: default response