.env

@@ -19,6 +19,14 @@ DOCC_GITHUB_OUTPUT=./docs
 DOCC_GITHUB_BASE_PATH=asconnect-service
 DOCC_PREVIEW_URL=http://localhost:8080/documentation/asconnectservice
 
+# --- OPEN API SPECIFICATION ---
+
+OAS_DOWNLOAD_FOLDER=./oas-download
+OAS_DOWNLOAD_FILE=$(OAS_DOWNLOAD_FOLDER)/openapi.oas.json
+OAS_DOWNLOAD_INPUT=$(OAS_DOWNLOAD_FOLDER)/asconnect-openapi-specification.zip
+OAS_DOWNLOAD_OUTPUT=Sources/$(SPM_LIBRARY_TARGET)/openapi.json
+OAS_DOWNLOAD_URL=https://developer.apple.com/sample-code/app-store-connect/app-store-connect-openapi-specification.zip
+
 # -- SWIFT PACKAGE MANAGER ---
 
 SPM_LIBRARY_TARGET=ASConnectService

Makefile

@@ -86,6 +86,17 @@ doc-preview: ## Previews the library documentation in Safari
 		--include-extended-types \
 		--enable-inherited-docs
 
+# OPEN API SPECIFICATION
+
+oas-download: ## Downloads the latest App Store Connect OpenAPI specification document
+	@mkdir -p $(OAS_DOWNLOAD_FOLDER)
+	@curl -fsSL \
+		"$(OAS_DOWNLOAD_URL)" \
+		-o "$(OAS_DOWNLOAD_INPUT)"
+	@unzip -q "$(OAS_DOWNLOAD_INPUT)" -d "$(OAS_DOWNLOAD_FOLDER)"
+	@mv "$(OAS_DOWNLOAD_FILE)" "$(OAS_DOWNLOAD_OUTPUT)"
+	@rm -rf "$(OAS_DOWNLOAD_FOLDER)"
+
 # IDE
 
 ide-xcode: ## Opens this package with Xcode