copied code generated from swagger

service/bitbucket/openapi/README.md

@@ -0,0 +1,36 @@
+# Bitbucket OpenAPI
+
+Bitbucket API swagger definitions can be found here [Bitbucket API](https://developer.atlassian.com/bitbucket/api/2/reference/meta/serialization#oai).
+
+However, unfortunately it is not valid OpenAPI definition, see this issues:
+
+1. [ktrysmt/go-bitbucket Issue #96](https://github.com/ktrysmt/go-bitbucket/issues/96)
+
+1. [JIRA Bitbucket Cloud/BCLOUD-17601 - api.bitbucket.org/swagger.json is invalid](https://jira.atlassian.com/browse/BCLOUD-17601)
+
+However I was able to generate some models via [OpenAPI Generator CLI](https://github.com/OpenAPITools/openapi-generator-cli/) with `--skip-validate-spec` ignoring the errors.
+Here I copied only models related to [Code Insights](https://support.atlassian.com/bitbucket-cloud/docs/code-insights/).
+Feel free to extend if needed.
+
+## Attempts to generate code
+
+- Go Swagger:
+
+    ```sh
+    $ swagger validate https://bitbucket.org/api/swagger.json
+    json: cannot unmarshal bool into Go struct field SwaggerProps.definitions of type []string
+    ```
+
+- OpenAPI Generator CLI:
+
+    ```sh
+    $ docker run --rm -v "${PWD}:/local" \
+        openapitools/openapi-generator-cli generate \
+             -i https://api.bitbucket.org/swagger.json
+             -g go \
+             -o /local/out/go
+    ...
+    Exception in thread "main" org.openapitools.codegen.SpecValidationException: There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
+    | Error count: 53, Warning count: 17
+    ...
+    ```