# paths./.summary
The JSON/HTML version of a landing page containing links to the API documentation.

# paths./.description
A landing page for the Personalized Greeting API.

# paths./.get.summary
Retrive a landing page for the API.  The landing page may return a HTML or JSON body with links to various endpoints of the API.

# paths./.well-known/{well_known_name}.summary
There are may dot well-known specifications avaliable and the well_known_name path parameter should describe a specific specification.  The Personalized Greeting API is part of a portfolio of APIs that Michael is putting together.  The well know location for api-catalog is part of this demonstration.  So if you specify api-catalog for the well_known_name, you will get a list of APIs that Michael is developing.

# paths./.well-known/{well_known_name}.description
Dot well-known is an Internet standard for describing common things on a website.

# paths./.well-known/{well_known_name}.get.summary
Some URL represent well know Internet services.  Use this endpoint to retrieve information from a specified well-known service.

# paths./.well-known/{well_known_name}.get.description
Returns specific well-known information about the API

# paths./.well-known/{well_known_name}.get.parameters[].description
The name of the well-known information to retrieve.

# paths./api.summary
The intent of the 'api' endpoint is to provide developers and development tools with a machine-readable description of the API.  The documentation is provided as a JSON document that follows version 3.0 of the OpenAPI Specification.

# paths./api.description
A JSON view of the Personalized Greeting API as document using the OpenAPI Specification version 3.0.

# paths./api.get.summary
The JSON representation of this document.  The intent is to allow developer tools create code stubs to call the API.

# paths./conformance.summary
One of the purposes of this API is to investigate various ways of documenting APIs that conform to requirements published by the Open GeoSpatial Consortium (OGC).  In particular, to describe security controls in an API.  Thus, this endpoint describes a list of requirements.

# paths./conformance.description
Information about the conformance requirements for the Personalized Greeting API.

# paths./conformance.get.summary
This API conforms to the OGC API Common Specification and IETF RFC for Secuity.  Use this endpoint to see a list of supported conformance classes.

# paths./conformance.get.description
Return conformance information for the API

# paths./conformance/{conformance_alias}.summary
One of the purposes of this API is to investigate various ways of documenting APIs that conform to requirements published by the Open GeoSpatial Consortium (OGC).  In particular, to describe security controls in an API.  Thus, this endpoint describes a list of requirements, when the conformance_alias is not specified, or a particular conformance requirement, when the conformance_alias is specified.  

# paths./conformance/{conformance_alias}.description
Information about a conformance requirement for the Personalized Greeting API.

# paths./conformance/{conformance_alias}.get.summary
Use this endpoint to retrieve information about a specific conformance class the API supports.

# paths./conformance/{conformance_alias}.get.description
Returns specific conformance information for the API

# paths./conformance/{conformance_alias}.get.parameters[].description
The alias of the conformance information to retrieve

# paths./documentation.summary
The intent of the documentation endpoint is to generate documentations from the content of an OpenAPI document.  The objective is for developers to understand and experiment with creating authenticated personalized greetings.

# paths./documentation.description
The HTML view of the methods and properties for the Personalized Greeting API.

# paths./documentation.get.summary
The HTML representation of this document.  The intent is to allow developers to learn about the API and experiment with the use of the API.

# paths./index.html.summary
An HTML version of a landing page containing links to the API documentation.

# paths./index.html.description
A landing page for the Personalized Greeting API.

# paths./index.html.get.summary
The HTML representation of the Personalized Greeting API Landing Page.  The page contains information about the API.

# paths./retrieve.summary
An authorized user may use this endpoint to retrieve a JSON greeting to the World with a GET method.  An authorized user may also use this endpoint to retrieve a JSON greeting base on a Geographic location they provide.  The endpoint is protected with Basic Authentication.  You can register a new user account at https://security.i7es.click/register.  Everyone is free to sign up.  The code is available on GitHub at  https://github.com/leedahl/OGC_LandingPage with an Open Source MIT license.

# paths./retrieve.description
A Hello World or Geographic greeting depending on if the request is GET or POST operation.

# paths./retrieve.get.summary
Retrieve a Hello World greeting response.  The retrieve method demonstratates the use of Basic Authentication to access a protected API.

# paths./retrieve.post.summary
Retrieve a Geographic Location based greeting.  The retrieve method demonstratates the use of Basic Authentication to access a protected API.

# paths./retrieve.post.description
Returns a greeting based on a specified location

# paths./retrieve/{name}.summary
An authorized user may use this endpoint to retrieve a JSON greeting to the a personalized name.  The endpoint is protected with Basic Authentication.  You can register a new user account at https://security.i7es.click/register.  Everyone is free to sign up.  The code is available on GitHub at  https://github.com/leedahl/OGC_LandingPage with an Open Source MIT license.

# paths./retrieve/{name}.description
A Personalized Hello World style greeting that greets the name specified in the {name} paath parameter.

# paths./retrieve/{name}.get.summary
Retrieve a Personalize Greeting response based on the specified name.  The endpoint is an.example of a protected endpoint using Basic Authentication.

# paths./retrieve/{name}.get.description
Returns a personalized greeting message for the specified name

# components.schemas.Error.properties.type.description
A URI reference that identifies the problem type

# components.schemas.Error.properties.title.description
A short, human-readable summary of the problem type

# components.schemas.Error.properties.detail.description
A human-readable explanation specific to this occurrence of the problem

# components.schemas.GreetingPoint.properties.coordinates.description
A set of longitude, latitude coordinate values.

# components.schemas.GreetingStGeorge.properties.greeting.example
Hello to the kind people of St. George, Washington County, Utah, United States!

# components.securitySchemes.basicAuth.description
Basic authentication using username and password

# info.description
An authentication protected API to demonstratate securing an API with a Personalized Hello World style Greeting.

# servers[].description
Production server where the documentation and API reside.