Merge pull request #158 from fingerprintjs/feat/open-api-v2.2.0

OpenAPI schema sync
fingerprintjs · Nov 26, 2024 · 7ab634e · 7ab634e
2 parents ad33cd2 + cdf62af
commit 7ab634e
Show file tree

Hide file tree

Showing 19 changed files with 567 additions and 129 deletions.
diff --git a/.changeset/forty-seas-prove.md b/.changeset/forty-seas-prove.md
@@ -0,0 +1,5 @@
+---
+'@fingerprintjs/fingerprintjs-pro-server-api': minor
+---
+
+Add `relay` detection method to the VPN Detection Smart Signal
diff --git a/.changeset/orange-poets-drive.md b/.changeset/orange-poets-drive.md
@@ -0,0 +1,5 @@
+---
+'@fingerprintjs/fingerprintjs-pro-server-api': minor
+---
+
+**events**: Add a `suspect` field to the `identification` product schema
diff --git a/.github/workflows/functional_tests.yml b/.github/workflows/functional_tests.yml
@@ -21,7 +21,7 @@ jobs:
       max-parallel: 3
       fail-fast: false
       matrix:
-        node-version: [18, 19, 20, 21]
+        node-version: [18, 19, 20, 21, 22]
 
     steps:
       - if: ${{ github.event_name == 'pull_request_target' }}

diff --git a/.schema-version b/.schema-version
@@ -1 +1 @@
-v2.1.0
+v2.2.0
diff --git a/resources/fingerprint-server-api.yaml b/resources/fingerprint-server-api.yaml
@@ -394,6 +394,76 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
+  /related-visitors:
+    get:
+      tags:
+        - Fingerprint
+      operationId: getRelatedVisitors
+      summary: Get Related Visitors
+      description: >
+        Related visitors API lets you link web visits and in-app browser visits
+        that originated from the same mobile device.
+
+        It searches the past 6 months of identification events to find the
+        visitor IDs that belong to the same mobile device as the given visitor
+        ID.
+
+
+        ⚠️ Please note that this API is not enabled by default and is billable
+        separately. ⚠️
+
+
+        If you would like to use Related visitors API, please contact our
+        [support team](https://fingerprint.com/support).
+
+        To learn more, see [Related visitors API
+        reference](https://dev.fingerprint.com/reference/related-visitors-api).
+      parameters:
+        - name: visitor_id
+          in: query
+          required: true
+          schema:
+            type: string
+          description: >-
+            The [visitor
+            ID](https://dev.fingerprint.com/reference/get-function#visitorid)
+            for which you want to find the other visitor IDs that originated
+            from the same mobile device.
+      responses:
+        '200':
+          description: OK.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RelatedVisitorsResponse'
+        '400':
+          description: >-
+            Bad request. The visitor ID parameter is missing or in the wrong
+            format.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: Forbidden. Access to this API is denied.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: >-
+            Not found. The visitor ID cannot be found in this application's
+            data.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '429':
+          description: Too Many Requests. The request is throttled.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
   /webhook:
     trace:
       tags:
@@ -527,6 +597,7 @@ paths:
                             publicVPN: false
                             auxiliaryMobile: false
                             osMismatch: false
+                            relay: false
                         proxy:
                           result: false
                         tampering:
@@ -609,76 +680,6 @@ paths:
               responses:
                 default:
                   description: The server doesn't validate the answer.
-  /related-visitors:
-    get:
-      tags:
-        - Fingerprint
-      operationId: getRelatedVisitors
-      summary: Get Related Visitors
-      description: >
-        Related visitors API lets you link web visits and in-app browser visits
-        that originated from the same mobile device.
-
-        It searches the past 6 months of identification events to find the
-        visitor IDs that belong to the same mobile device as the given visitor
-        ID.
-
-
-        ⚠️ Please note that this API is not enabled by default and is billable
-        separately. ⚠️
-
-
-        If you would like to use Related visitors API, please contact our
-        [support team](https://fingerprint.com/support).
-
-        To learn more, see [Related visitors API
-        reference](https://dev.fingerprint.com/reference/related-visitors-api).
-      parameters:
-        - name: visitor_id
-          in: query
-          required: true
-          schema:
-            type: string
-          description: >-
-            The [visitor
-            ID](https://dev.fingerprint.com/reference/get-function#visitorid)
-            for which you want to find the other visitor IDs that originated
-            from the same mobile device.
-      responses:
-        '200':
-          description: OK.
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/RelatedVisitorsResponse'
-        '400':
-          description: >-
-            Bad request. The visitor ID parameter is missing or in the wrong
-            format.
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ErrorResponse'
-        '403':
-          description: Forbidden. Access to this API is denied.
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ErrorResponse'
-        '404':
-          description: >-
-            Not found. The visitor ID cannot be found in this application's
-            data.
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ErrorResponse'
-        '429':
-          description: Too Many Requests. The request is throttled.
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ErrorResponse'
 components:
   securitySchemes:
     ApiKeyHeader:
@@ -918,6 +919,12 @@ components:
         linkedId:
           type: string
           description: A customer-provided id that was sent with the request.
+        suspect:
+          description: >-
+            Field is `true` if you have previously set the `suspect` flag for
+            this event using the [Server API Update event
+            endpoint](https://dev.fingerprint.com/reference/updateevent).
+          type: boolean
         timestamp:
           description: Timestamp of the event with millisecond precision in Unix time.
           type: integer
@@ -1288,6 +1295,7 @@ components:
         - publicVPN
         - auxiliaryMobile
         - osMismatch
+        - relay
       properties:
         timezoneMismatch:
           type: boolean
@@ -1309,6 +1317,23 @@ components:
           description: >-
             The browser runs on a different operating system than the operating
             system inferred from the request network signature.
+        relay:
+          type: boolean
+          description: >
+            Request IP address belongs to a relay service provider, indicating
+            the use of relay services like [Apple Private
+            relay](https://support.apple.com/en-us/102602) or [Cloudflare
+            Warp](https://developers.cloudflare.com/warp-client/). 
+
+
+            * Like VPNs, relay services anonymize the visitor's true IP address.
+
+            * Unlike traditional VPNs, relay services don't let visitors spoof
+            their location by choosing an exit node in a different country.
+
+
+            This field allows you to differentiate VPN users and relay service
+            users in your fraud prevention logic.
     VPN:
       type: object
       additionalProperties: false
@@ -1947,6 +1972,27 @@ components:
       properties:
         error:
           type: string
+    RelatedVisitor:
+      type: object
+      additionalProperties: false
+      required:
+        - visitorId
+      properties:
+        visitorId:
+          type: string
+          description: >-
+            Visitor ID of a browser that originates from the same mobile device
+            as the input visitor ID.
+    RelatedVisitorsResponse:
+      type: object
+      additionalProperties: false
+      required:
+        - relatedVisitors
+      properties:
+        relatedVisitors:
+          type: array
+          items:
+            $ref: '#/components/schemas/RelatedVisitor'
     WebhookRootApps:
       type: object
       additionalProperties: false
@@ -2360,24 +2406,3 @@ components:
           $ref: '#/components/schemas/WebhookVelocity'
         developerTools:
           $ref: '#/components/schemas/WebhookDeveloperTools'
-    RelatedVisitor:
-      type: object
-      additionalProperties: false
-      required:
-        - visitorId
-      properties:
-        visitorId:
-          type: string
-          description: >-
-            Visitor ID of a browser that originates from the same mobile device
-            as the input visitor ID.
-    RelatedVisitorsResponse:
-      type: object
-      additionalProperties: false
-      required:
-        - relatedVisitors
-      properties:
-        relatedVisitors:
-          type: array
-          items:
-            $ref: '#/components/schemas/RelatedVisitor'