Mirror Repo

Author: sukolenvo

.gitignore

@@ -0,0 +1,7 @@
+**/.DS_Store
+**/.idea
+*.iml
+
+# build files
+out/
+.vscode

Makefile

@@ -0,0 +1,9 @@
+PWD := $(shell eval pwd)
+validate:
+	# Validate conformance to the OpenAPI specification
+	docker run --rm -v ${PWD}/spec/openapi.yaml:/local/openapi.yaml openapitools/openapi-generator-cli validate -i file:///local/openapi.yaml --recommend
+
+ui:
+	echo "running spec via swagger-ui accessible at http://localhost:9500"
+	`pwd`/util/open-ui.sh "http://localhost:9500" &
+	docker run --rm -p 9500:8080 -v `pwd`/spec/openapi.yaml:/usr/share/nginx/html/openapi.yaml -e API_URL=openapi.yaml swaggerapi/swagger-ui

README.md

@@ -0,0 +1,18 @@
+# WiseTime Connect API Spec
+
+The WiseTime Connect API allows you to connect your systems to WiseTime. The API is specified using the [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification), version [3.0.1](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md). The spec is available in this repository at [spec/openapi.yaml](spec/openapi.yaml).
+
+We provide a web UI that you can use to browse the API at [https://wisetime.com/docs/connect/api/](https://wisetime.com/docs/connect/api/).
+
+## Generating WiseTime Connect API Client Libraries
+
+While you can consume the WiseTime Connect API directly via HTTP, you also have the option of generating client libraries for various languages and frameworks.
+
+To do that, you can use a tool called [openapi-generator](https://github.com/OpenAPITools/openapi-generator). For example, to generate a Go client library via an openapi-generator Docker container:
+
+```sh
+docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
+    -i https://raw.githubusercontent.com/wisetime-io/connect-api-spec/master/spec/openapi.yaml \
+    -g go \
+    -o /local/out/go
+```

connector-service

@@ -0,0 +1 @@
+Subproject commit 89baa2716ea681d23f7dbaae30b423db7897b2bd