Improve Auth API References

https://generator.swagger.io/?url=https://skygeario.github.io/skygear-server/apis/auth/1ee2cce.yaml

1. Make it explicit which request parameters is optional / required, both on schema and example values
2. Use real-life example value instead of dummy string like "type string" as of now, make it more descriptive and easier to read