Updates to AZ API spec - Githubissues

nasa / utm-apis

The collection of APIs for NASA's UTM project in the form of OpenAPI documents.

55 stars 35 forks source link

Updates to AZ API spec #170

Closed arkits closed 4 years ago

arkits commented 4 years ago

v1 -

Added ErrorResponse for /token
Removed TokenKeyResponse - not used
Misc clean-up to make it look pretty on Swagger U

v0 -

Bump to OpenAPI 3
Removed unused schemas and endpoints
Documented second permutation of the token endpoint

nasajoey commented 4 years ago

I'm not clear why there are two YAML files? I think I need to understand that before I fully review.

arkits commented 4 years ago

I'm not clear why there are two YAML files? I think I need to understand that before I fully review.

v0.yaml documents the legacy API (with basic auth). It still has a place... though maybe not under the fims-authz directory.

issmith1 commented 4 years ago

@nasajoey three services and their interface specs are described in the AZ repo. Since nup-oauth2 is internal only its API Spec can be moved away from public repo. It would go along side its service implementation.

https://github.com/nasa/FIMS-AUTHZ/blob/master/README.md

nasajoey commented 4 years ago

Thanks @arkits ... if you an make those minor documentation updates, I think I'm good.