From dc709ab351e8bf856ef439ab10b0d4220d9834c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Eray=20Ayd=C4=B1n?= Date: Thu, 24 Sep 2026 16:01:02 +0300 Subject: [PATCH 1/3] chore: update URLs for repository rename to openapi Point GitHub Pages URLs at `fingerprintjs.github.io/openapi`. Point repository links at `github.com/fingerprintjs/openapi`. Update `license.url` in the manually updated v3 SDK schema. Rename the package name to `openapi` and update the changesets changelog. Related-Task: INTER-2472 --- .changeset/config.json | 2 +- .changeset/openapi-repo-rename-license-url.md | 5 +++++ .github/workflows/schema-diff-pr-comment.yml | 2 +- AGENTS.md | 2 +- CHANGELOG.md | 2 +- CONTRIBUTING.md | 16 ++++++++-------- README.md | 8 ++++---- package.json | 2 +- schemas/fingerprint-server-api-for-sdks.yaml | 2 +- scripts/schemaDiffPublished.ts | 2 +- 10 files changed, 24 insertions(+), 19 deletions(-) create mode 100644 .changeset/openapi-repo-rename-license-url.md diff --git a/.changeset/config.json b/.changeset/config.json index 14b404e3..594ff87b 100644 --- a/.changeset/config.json +++ b/.changeset/config.json @@ -14,7 +14,7 @@ "changelog": [ "@fingerprintjs/changesets-changelog-format", { - "repo": "fingerprintjs/fingerprint-pro-server-api-openapi" + "repo": "fingerprintjs/openapi" } ] } diff --git a/.changeset/openapi-repo-rename-license-url.md b/.changeset/openapi-repo-rename-license-url.md new file mode 100644 index 00000000..791c2391 --- /dev/null +++ b/.changeset/openapi-repo-rename-license-url.md @@ -0,0 +1,5 @@ +--- +'openapi': patch +--- + +Update `license.url` for the Server API v3 to point at the renamed `fingerprintjs/openapi` repository diff --git a/.github/workflows/schema-diff-pr-comment.yml b/.github/workflows/schema-diff-pr-comment.yml index 9b1219b3..ea02b936 100644 --- a/.github/workflows/schema-diff-pr-comment.yml +++ b/.github/workflows/schema-diff-pr-comment.yml @@ -42,7 +42,7 @@ jobs: - name: Compute known remote schema files id: known-remote env: - MANIFEST_URL: https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/schemas/index.json + MANIFEST_URL: https://fingerprintjs.github.io/openapi/schemas/index.json run: | KNOWN_REMOTE_FILES="$(curl -fsSL "$MANIFEST_URL" | jq -r '.files[]' | paste -sd, -)" echo "files=${KNOWN_REMOTE_FILES}" >> "$GITHUB_OUTPUT" diff --git a/AGENTS.md b/AGENTS.md index 1e8d9582..172b6069 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,7 +34,7 @@ Example: ```markdown --- -'fingerprint-pro-server-api-openapi': minor +'openapi': minor --- **events**: Add `proxy_ml_score` to `Event` diff --git a/CHANGELOG.md b/CHANGELOG.md index 5da4afab..e3fb7dbe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,4 @@ -# fingerprint-pro-server-api-openapi +# openapi ## 3.7.1 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 798618ff..216e515f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -18,7 +18,7 @@ You can find the schemas definitions in the [schemas](/schemas) folder. You can Use the included [Swagger UI](https://github.com/swagger-api/swagger-ui) demo app to dynamically render your changes into a documentation site a preview them there. Some mistakes and inconsistencies are much easier to spot in rendered documentation than by looking at the raw schema. -1. Clone this repository: `git clone https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi.git` +1. Clone this repository: `git clone https://github.com/fingerprintjs/openapi.git` 2. Install dependencies: `pnpm install` 3. Run `pnpm dev` to start the demo app @@ -45,7 +45,7 @@ Optional: - Save a JSON report: `pnpm schema:diff:published -- --json-out ./tmp/schema-diff-report.json` - Save the rendered PR comment body: `pnpm schema:diff:published -- --comment-out ./tmp/schema-diff-comment.md` - Compare against a custom published base URL: - `pnpm schema:diff:published -- --base-url https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/schemas` + `pnpm schema:diff:published -- --base-url https://fingerprintjs.github.io/openapi/schemas` ### Schema Validation @@ -62,7 +62,7 @@ To validate that schema matches the actual API implementation we use a [special ### Describing changes -[Releases](https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi/releases) from this repository are propagated to our server-side SDKs, that's why it's important to provide meaningful release notes if there are relevant changes. +[Releases](https://github.com/fingerprintjs/openapi/releases) from this repository are propagated to our server-side SDKs, that's why it's important to provide meaningful release notes if there are relevant changes. We use [changesets](https://github.com/changesets/changesets) for that. If you want to describe your changes, run: ```sh @@ -74,7 +74,7 @@ Example changeset looks like this: ```markdown --- -'fingerprint-pro-server-api-openapi': minor +'openapi': minor --- **visitors**: Add the confidence field to the VPN Detection Smart Signal @@ -84,7 +84,7 @@ Example changeset looks like this: - `visitors` - scope of the changes. Scopes are defined in the [config/scopes.yaml](config/scopes.yaml) file. Certain scopes are ignored in certain SDKs if they are not supported, meaning that they will be ignored for them. You will be prompted to select scope in the CLI. - `Add the confidence field to the VPN Detection Smart Signal` - meaningful description of the change. -- `fingerprint-pro-server-api-openapi` - name of the package +- `openapi` - name of the package - `minor` - version of the change, can be: `patch`, `minor`, `major` #### Choosing the version bump @@ -101,8 +101,8 @@ Don't create a changeset for documentation-only changes (descriptions, examples) On every push into `main` (merged PR): -- The built schema is published to [GitHub pages](https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/). -- The built schema is published as a [raw yaml file](https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/schemas/fingerprint-server-api.yaml). +- The built schema is published to [GitHub pages](https://fingerprintjs.github.io/openapi/). +- The built schema is published as a [raw yaml file](https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api.yaml). - After GitHub Pages deploy, the docs repo OpenAPI sync workflows run. They open a PR only if the published spec changed, which updates the [API Reference](https://docs.fingerprint.com/reference/server-api-v4). See the [publish.yml](.github/workflows/publish.yml) workflow for more details. @@ -111,7 +111,7 @@ See the [publish.yml](.github/workflows/publish.yml) workflow for more details. GitHub releases are used to generate Server SDKs based on a specific version of the OpenAPI schema. -After merging to `main`, if there are relevant changes, you can manually trigger the [Release](https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi/actions/workflows/release.yml) workflow, which will consume created changeset files and create PR with bumped version and updated changelog. +After merging to `main`, if there are relevant changes, you can manually trigger the [Release](https://github.com/fingerprintjs/openapi/actions/workflows/release.yml) workflow, which will consume created changeset files and create PR with bumped version and updated changelog. ### Release note sync with SDKs diff --git a/README.md b/README.md index e6bd35cf..9527ee7a 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@

- CI badge + CI badge Discord server

@@ -21,8 +21,8 @@ This repository contains the [OpenAPI](https://spec.openapis.org/oas/) schema of ## Getting started -- The OpenAPI schema is published to the [Fingerprint API reference](https://docs.fingerprint.com/reference/server-api) and also as a [Swagger UI app on GitHub pages](https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/). -- You can also [download the latest schema file here](https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/schemas/fingerprint-server-api-v4-with-examples.yaml). +- The OpenAPI schema is published to the [Fingerprint API reference](https://docs.fingerprint.com/reference/server-api) and also as a [Swagger UI app on GitHub pages](https://fingerprintjs.github.io/openapi/). +- You can also [download the latest schema file here](https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-v4-with-examples.yaml). > [!NOTE] > Please note that some signals and attributes present in the schema are only available to Enterprise or Pro Plus customers on request, as indicated in the signal description. @@ -33,7 +33,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for more information. ## Support and feedback -To report problems, ask questions, or provide feedback, please use [Issues](https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi/issues). If you need private support, you can email us at [oss-support@fingerprint.com](mailto:oss-support@fingerprint.com). +To report problems, ask questions, or provide feedback, please use [Issues](https://github.com/fingerprintjs/openapi/issues). If you need private support, you can email us at [oss-support@fingerprint.com](mailto:oss-support@fingerprint.com). ## License diff --git a/package.json b/package.json index d817b6a6..a8730af7 100644 --- a/package.json +++ b/package.json @@ -1,5 +1,5 @@ { - "name": "fingerprint-pro-server-api-openapi", + "name": "openapi", "private": true, "version": "3.7.1", "main": "index.js", diff --git a/schemas/fingerprint-server-api-for-sdks.yaml b/schemas/fingerprint-server-api-for-sdks.yaml index 7dc7c161..34358bdd 100644 --- a/schemas/fingerprint-server-api-for-sdks.yaml +++ b/schemas/fingerprint-server-api-for-sdks.yaml @@ -27,7 +27,7 @@ info: license: name: MIT url: >- - https://github.com/fingerprintjs/fingerprint-pro-server-api-openapi/blob/main/LICENSE + https://github.com/fingerprintjs/openapi/blob/main/LICENSE tags: - name: Fingerprint description: >- diff --git a/scripts/schemaDiffPublished.ts b/scripts/schemaDiffPublished.ts index 687051e9..86281888 100644 --- a/scripts/schemaDiffPublished.ts +++ b/scripts/schemaDiffPublished.ts @@ -7,7 +7,7 @@ import { renderSchemaDiffComment } from '../utils/schemaDiff/renderComment.ts'; import { buildUnifiedPatch } from '../utils/schemaDiff/unifiedPatch.ts'; import type { OpenApiDocument } from '../utils/openapi.ts'; -const DEFAULT_BASE_URL = 'https://fingerprintjs.github.io/fingerprint-pro-server-api-openapi/schemas'; +const DEFAULT_BASE_URL = 'https://fingerprintjs.github.io/openapi/schemas'; const DEFAULT_LOCAL_DIR = 'dist/schemas'; interface CliOptions { From 8fc2f8bf15babfbf5b688884001aaa342d3ca3bd Mon Sep 17 00:00:00 2001 From: Eray AYDIN Date: Fri, 25 Sep 2026 01:59:54 +0300 Subject: [PATCH 2/3] chore: update changeset note about license.url --- .changeset/openapi-repo-rename-license-url.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changeset/openapi-repo-rename-license-url.md b/.changeset/openapi-repo-rename-license-url.md index 791c2391..35aaf726 100644 --- a/.changeset/openapi-repo-rename-license-url.md +++ b/.changeset/openapi-repo-rename-license-url.md @@ -2,4 +2,4 @@ 'openapi': patch --- -Update `license.url` for the Server API v3 to point at the renamed `fingerprintjs/openapi` repository +Update `license.url` for the Server API v3 From 5a35bee727bf5de198abb1ce18af18867f915bbe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Eray=20Ayd=C4=B1n?= Date: Mon, 28 Sep 2026 13:11:38 +0300 Subject: [PATCH 3/3] docs: fix schema links --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9527ee7a..106998ac 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,8 @@ This repository contains the [OpenAPI](https://spec.openapis.org/oas/) schema of ## Getting started - The OpenAPI schema is published to the [Fingerprint API reference](https://docs.fingerprint.com/reference/server-api) and also as a [Swagger UI app on GitHub pages](https://fingerprintjs.github.io/openapi/). -- You can also [download the latest schema file here](https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-v4-with-examples.yaml). +- You can also download the latest schema as [Server API schema (YAML)](https://docs.fingerprint.com/reference/server-api.yaml) or [Server API schema (JSON)](https://docs.fingerprint.com/reference/server-api.json). +- If you need the examples too, use [Server API schema with examples](https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-v4-with-examples.yaml). > [!NOTE] > Please note that some signals and attributes present in the schema are only available to Enterprise or Pro Plus customers on request, as indicated in the signal description.