Add swagger endpoints for Netlify Identity

[NotWoods]

Fixes #79

[netlify]

✔️ Deploy Preview for open-api ready!

🔨 Explore the source changes: 88b1481

🔍 Inspect the deploy log: https://app.netlify.com/sites/open-api/deploys/60c7906ec8dc100008d8d975

😎 Browse the preview: https://deploy-preview-344--open-api.netlify.app

[rstavchansky]

I'm getting a Page not found error when attempting to access the deploy preview.
I noticed that there don't seem to be updates to this section of the OpenAPI spec, and I would think it would need additions so that the Identity endpoints show up in docs output:

open-api/swagger.yml

Line 3250 in f451091

x-tagGroups:

[rstavchansky]

Thanks for the update @NotWoods. I see the output showing up now in the API reference docs.
I did want to note that the issue #79 also includes this:

We also need to add identity_instance_id to the payload of the site endpoint.

From a quick search, it looks like this would go within this object here:

open-api/swagger.yml

Line 2236 in 1456629

site:

[bryanmikaelian]

Changes are looking good to me too. Just a few errors I noticed when testing on https://editor.swagger.io/#

Semantic error at paths./sites/{site_id}/identity/{identity_instance_id}
Declared path parameter "site_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 216

Semantic error at paths./sites/{site_id}/identity/{identity_instance_id}
Declared path parameter "identity_instance_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 216

Semantic error at paths./sites/{site_id}/identity/{identity_instance_id}/users/{user_id}.put.parameters
Multiple body parameters are not allowed.
Jump to line 291

Structural error at paths./sites/{site_id}/identity/{identity_instance_id}/users.get.parameters.4
should have required property 'type'
missingProperty: type
Jump to line 244

Structural error at paths./sites/{site_id}/identity/{identity_instance_id}/users.get.parameters.5
should NOT have additional properties
additionalProperty: schema
Jump to line 248

Structural error at paths./sites/{site_id}/identity/{identity_instance_id}/users/{user_id}.delete.responses.200.schema.properties
should be object
Jump to line 361

[rstavchansky]

Thanks for adding identity_instance_id to the site body. I'll let @bryanmikaelian confirm the final details of the approval.

[bryanmikaelian]

LGTM ✨

[NotWoods]

bumping this discussion :) Are there any steps I need to take to help get this merged?

[bryanmikaelian]

@NotWoods 👍🏻 Sorry for the delay on the +1