Merge pull request #1454 from maxmind/kevin/lychee

mm-kevcenteno · web-flow · commit 9bc344b6ba7d · 2025-10-16T16:55:33.000-04:00
Add link checking github action
diff --git a/.github/workflows/links.yml b/.github/workflows/links.yml
@@ -0,0 +1,29 @@
+name: Links
+
+on:
+  push:
+
+jobs:
+  linkChecker:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write # required for peter-evans/create-issue-from-file
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+
+      - name: Link Checker
+        id: lychee
+        uses: lycheeverse/lychee-action@885c65f3dc543b57c898c8099f4e08c8afd178a2
+        with:
+          fail: true
+          args: --accept '100..=103, 200..=299, 403, 429' './**/*.md' './**/*.html'
+
+      - name: Create Issue From File
+        if: steps.lychee.outputs.exit_code != 0
+        uses: peter-evans/create-issue-from-file@fca9117c27cdc29c6c4db3b86c48e4115a786710
+        with:
+          title: Link Checker Report
+          content-filepath: ./lychee/out.md
+          labels: report, automated issue
diff --git a/.lycheeignore b/.lycheeignore
@@ -0,0 +1,5 @@
+^file://
+^https://sandbox\.maxmind\.com
+^https://deno\.land
+^https://jsr\.io
+^https://minfraud\.maxmind\.com
diff --git a/README.md b/README.md
@@ -71,7 +71,7 @@ Download
 [Embedded Dart Sass](https://github.com/sass/dart-sass-embedded/releases) and
 make sure it is in your `$PATH`. This is necessary for Hugo to process SASS and
 SCSS files. See the
-[Hugo documentation](https://gohugo.io/hugo-pipes/scss-sass/) for more
+[Hugo documentation](https://gohugo.io/functions/css/sass/#dart-sass) for more
 information.
 
 ### Development
diff --git a/assets/snippets/sandbox-learn-more.md b/assets/snippets/sandbox-learn-more.md
@@ -1,2 +1,2 @@
 You can
-[learn more about the MaxMind Sandbox on our Knowledge Base](https://support.maxmind.com/hc/en-us/sections/8603980533659-Sandbox-Environment).
+[learn more about the MaxMind Sandbox on our Knowledge Base](https://support.maxmind.com/knowledge-base/account-and-purchasing#sandbox-environment).
diff --git a/assets/snippets/sandbox-limits.md b/assets/snippets/sandbox-limits.md
@@ -3,4 +3,4 @@ The Sandbox should not be used to test the capacity of the production web
 service in high volume situations.
 
 If you are running into the request limit and need help, please
-[reach out to our support team for assistance](https://support.maxmind.com/hc/en-us/requests/new).
+[reach out to our support team for assistance](https://support.maxmind.com).
diff --git a/content/contribute.md b/content/contribute.md
@@ -47,7 +47,7 @@ minor modifications.
 
 If you would like us to feature an API or tool that you’ve developed for use
 with our products and services, please
-[contact our support team](https://support.maxmind.com/hc/en-us/requests/new)
+[contact our support team](https://support.maxmind.com)
 with a brief description of the tool and a link to the code and documentation.
 We do not guarantee that we will feature all contributions on our site, but
 we’re always interested to see what you come up with.
@@ -59,5 +59,5 @@ may be interested in referring your users to MaxMind through our Affiliate
 Program.
 
 You can
-[learn more about the MaxMind Affiliate Program for developers on our Knowledge Base](https://support.maxmind.com/hc/en-us/sections/5066199198619-Affiliate-Program),
+[learn more about the MaxMind Affiliate Program for developers on our Knowledge Base](https://support.maxmind.com/knowledge-base/account-and-purchasing#affiliate-program),
 including how to apply.
diff --git a/content/geoip/docs/web-services.md b/content/geoip/docs/web-services.md
@@ -166,7 +166,7 @@ help us investigate an issue:
 - Date and time frame (including time zone) that you experienced the issue
 - Your traceroute to `geoip.maxmind.com`
 
-[You can submit your support request on our knowledge base.](https://support.maxmind.com/hc/en-us/requests/new)
+[You can submit your support request on our knowledge base.](https://support.maxmind.com)
 
 ## Command Line (curl) Examples
 
diff --git a/content/geoip/docs/web-services/legacy.md b/content/geoip/docs/web-services/legacy.md
@@ -486,7 +486,7 @@ encoding is also referred to as latin1.
             <li>
               <strong>PERMISSION_REQUIRED</strong> – This is returned if you do
               not have permission to use the service. Please
-              <a href="https://support.maxmind.com/hc/en-us/requests/new"
+              <a href="https://support.maxmind.com"
                 >contact our support team</a
               >
               for more information.
diff --git a/content/geoip/docs/web-services/responses.md b/content/geoip/docs/web-services/responses.md
@@ -136,7 +136,7 @@ to handle any valid HTTP `4xx` or `5xx` status code.
         <td>402 Payment Required</td>
         <td>
           You do not have permission to use the service. Please
-          <a href="https://support.maxmind.com/hc/en-us/requests/new"
+          <a href="https://support.maxmind.com"
             >contact our support team</a
           >
           for more information.
diff --git a/content/geoip/geolocate-an-ip/client-side-javascript.md b/content/geoip/geolocate-an-ip/client-side-javascript.md
@@ -200,7 +200,7 @@ description of the error.
 | `DOMAIN_REGISTRATION_REQUIRED` | 401 Unauthorized     | The domain of your site is not registered.                                                                                                                |
 | `QUERY_FORBIDDEN`              | 401 Unauthorized     | You tried to access a service or feature that is not covered by your service plan.                                                                        |
 | `OUT_OF_QUERIES`               | 402 Payment Required | The license key you have provided is out of queries. Please purchase more queries to use this service.                                                    |
-| `PERMISSION_REQUIRED`          | 403 Forbidden        | You do not have permission to use the service. Please [contact our support team](https://support.maxmind.com/hc/en-us/requests/new) for more information. |
+| `PERMISSION_REQUIRED`          | 403 Forbidden        | You do not have permission to use the service. Please [contact our support team](https://support.maxmind.com) for more information. |
 | `HTTP_TIMEOUT`                 | (none)               | The request to the GeoIP web service timed out.                                                                                                           |
 | `HTTP_ERROR`                   | (none)               | There was an error making the request to the GeoIP web service.                                                                                           |
 
diff --git a/content/geoip/privacy-exclusions-api.md b/content/geoip/privacy-exclusions-api.md
@@ -119,7 +119,7 @@ to handle any valid HTTP 4xx or 5xx status code.
 | AUTHORIZATION_INVALID | 401 Unauthorized          | Your [account ID or license key](https://www.maxmind.com/en/accounts/current/license-key) could not be authenticated.                                     |
 | ACCOUNT_ID_REQUIRED   | 401 Unauthorized          | An [account ID and license key](https://www.maxmind.com/en/accounts/current/license-key) are required to use this service.                                |
 | LICENSE_KEY_REQUIRED  | 401 Unauthorized          | An [account ID and license key](https://www.maxmind.com/en/accounts/current/license-key) are required to use this service.                                |
-| PERMISSION_REQUIRED   | 403 Forbidden             | You do not have permission to use the service. Please [contact our support team](https://support.maxmind.com/hc/en-us/requests/new) for more information. |
+| PERMISSION_REQUIRED   | 403 Forbidden             | You do not have permission to use the service. Please [contact our support team](https://support.maxmind.com) for more information. |
 | _(none)_              | 503 Service Not Available | There is a problem with the web service server. You can [check the status of our services](https://status.maxmind.com), or try this request again later.  |
 
 #### Example Response (for an unsuccessful request)
diff --git a/content/geoip/release-notes/2019.md b/content/geoip/release-notes/2019.md
@@ -73,7 +73,7 @@ and unencrypted HTTP requests to MaxMind minFraud services on **October 16,
 error. Please update to TLS 1.2+ to avoid service disruption. You may need to
 upgrade your technology stack to a later version, or make code changes to do so.
 
-[Contact us](https://support.maxmind.com/hc/en-us/requests/new) for support or
+[Contact us](https://support.maxmind.com) for support or
 if you have questions.
 
 {{</ release-note >}}
@@ -139,7 +139,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -178,7 +178,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -207,7 +207,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -246,7 +246,7 @@ for more info. {{</ release-note >}}
 security of your MaxMind account, Chrome users can enable two-factor
 authentication (2FA). You can now add and require a (FIDO U2F) security key on
 top of your account credentials for a more secure log-in. See our
-[support center user guide](https://support.maxmind.com/hc/en-us/articles/1260803946470-Set-Up-Two-Factor-Authentication)
+[support center user guide](https://support.maxmind.com/knowledge-base/articles/two-factor-authentication-2fa)
 for information on how to set up 2FA. {{</ release-note >}}
 
 {{< release-note date="2019-01-24" title="Crimea accuracy update 2019" >}} We
diff --git a/content/geoip/release-notes/2020.md b/content/geoip/release-notes/2020.md
@@ -265,7 +265,7 @@ We've updated our Two-Factor Authentication (2FA) implementation to the
 [FIDO2 standard](https://fidoalliance.org/fido2/), which supports more web
 browsers and more types of security keys (e.g. supported biometrics keys). See
 our
-[Two-Factor Authentication (2FA) User Guide for more information](https://support.maxmind.com/hc/en-us/articles/1260803946470-Set-Up-Two-Factor-Authentication).
+[Two-Factor Authentication (2FA) User Guide for more information](https://support.maxmind.com/knowledge-base/articles/two-factor-authentication-2fa).
 {{</ release-note >}}
 
 {{< release-note date="2020-06-12" title="GeoNames Monthly Diff Report June 2020" >}}
diff --git a/content/geoip/release-notes/2022.md b/content/geoip/release-notes/2022.md
@@ -106,7 +106,7 @@ We've launched a new Sandbox Environment for technical validation and testing of
 your integration with our GeoIP and minFraud web services. The Sandbox
 environment is available for all paying MaxMind customers.
 
-[Learn more about the Sandbox environment on our Knowledge Base.](https://support.maxmind.com/hc/en-us/sections/8603980533659-Sandbox-Environment)
+[Learn more about the Sandbox environment on our Knowledge Base.](https://support.maxmind.com/knowledge-base/account-and-purchasing#sandbox-environment)
 
 [You can also read more about testing GeoIP web services on the Sandbox.](/geoip/docs/web-services/sandbox-environment)
 
diff --git a/content/geoip/release-notes/2024.md b/content/geoip/release-notes/2024.md
@@ -377,7 +377,7 @@ The following services will be impacted:
 
 [Learn more about user count data on our Knowledge Base.](https://support.maxmind.com/hc/en-us/articles/4408208479131-User-Context-Data#h_01FN9BT5PC591YRNBFZGHDYNS6)
 
-[Submit a support ticket request](https://support.maxmind.com/hc/en-us/requests/new)
+[Submit a support ticket request](https://support.maxmind.com)
 if you have questions or concerns.
 
 {{</ release-note >}}
diff --git a/content/minfraud/_index.md b/content/minfraud/_index.md
@@ -43,7 +43,7 @@ and Factors services.
   url: "/minfraud/release-notes"
   text: "Review minFraud release notes to understand changes to the minFraud API."
 - heading: "Knowledge Base"
-  url: "https://support.maxmind.com/hc/en-us/categories/1260801482329-minFraud-Web-Services"
+  url: "https://support.maxmind.com/knowledge-base/minfraud-web-services"
   text: "Consult our knowledge base for articles about using minFraud."
 {{</ link-group/container >}}
 
diff --git a/content/minfraud/api-documentation.md b/content/minfraud/api-documentation.md
@@ -78,7 +78,7 @@ help us investigate an issue:
 - Date and time frame (including time zone) that you experienced the issue
 - Your traceroute to `minfraud.maxmind.com`
 
-[You can submit your support request on our knowledge base.](https://support.maxmind.com/hc/en-us/requests/new)
+[You can submit your support request on our knowledge base.](https://support.maxmind.com)
 
 ## Versioning
 
diff --git a/content/minfraud/api-documentation/requests.md b/content/minfraud/api-documentation/requests.md
@@ -726,7 +726,7 @@ process that was used for the event.
 
   <!-- cspell: enable -->
 
-  If your payment processor is missing from this list, please [contact our support team](https://support.maxmind.com/hc/en-us/requests/new).
+  If your payment processor is missing from this list, please [contact our support team](https://support.maxmind.com).
   {{</minfraud-schema-row>}}
 
   {{< minfraud-schema-row key="was_authorized" type="request" valueType="boolean"  >}}
diff --git a/content/minfraud/api-documentation/responses.md b/content/minfraud/api-documentation/responses.md
@@ -161,7 +161,7 @@ to handle any valid HTTP `4xx` or `5xx` status code.
         <td>403 Forbidden</td>
         <td>
           You do not have permission to use the service. Please
-          <a href="https://support.maxmind.com/hc/en-us/requests/new"
+          <a href="https://support.maxmind.com"
             >contact our support team</a
           >
           for more information.
@@ -506,7 +506,7 @@ for more information.
   {{< minfraud-schema-row key="risk" type="response" valueType="decimal" valueTypeNote="min: 0.01, max: 99" score="true" insights="true" factors="true" >}}
   This field contains the risk associated with the IP address. The value ranges from 0.01 to 99\. A higher score indicates a higher risk.
 
-  [Learn more about the IP risk score on our Knowledge Base.](https://support.maxmind.com/hc/en-us/articles/4408382525851-Device-Risk-Scores#h%5F01FN6HE00G80Y22P4WSXJ81C6Y)
+  [Learn more about the IP risk score on our Knowledge Base.](https://support.maxmind.com/knowledge-base/articles/minfraud-ip-risk-score)
   {{</minfraud-schema-row>}}
 
   {{< minfraud-schema-row key="country" type="response" valueType="object" insights="true" factors="true" >}}
diff --git a/content/minfraud/minfraud-legacy.md b/content/minfraud/minfraud-legacy.md
@@ -1101,7 +1101,7 @@ current when they signed up for the service. The latest version is 1.3.
             <li>
               <strong>PERMISSION_REQUIRED</strong> – This is returned if you do
               not have permission to use the service. Please
-              <a href="https://support.maxmind.com/hc/en-us/requests/new"
+              <a href="https://support.maxmind.com"
                 >contact our support team</a
               >
               for more information.
diff --git a/content/minfraud/normalizing-email-addresses-for-minfraud.md b/content/minfraud/normalizing-email-addresses-for-minfraud.md
@@ -64,5 +64,5 @@ in various languages.
 - [Java](https://github.com/maxmind/minfraud-api-java/blob/main/src/main/java/com/maxmind/minfraud/request/Email.java#L414)
 - [JavaScript](https://github.com/maxmind/minfraud-api-node/blob/main/src/request/email.ts#L313)
 - [PHP](https://github.com/maxmind/minfraud-api-php/blob/main/src/MinFraud/Util.php#L284)
-- [Python](https://github.com/maxmind/minfraud-api-python/blob/main/minfraud/request.py#L357)
+- [Python](https://github.com/maxmind/minfraud-api-python/blob/main/src/minfraud/request.py#L375)
 - [Ruby](https://github.com/maxmind/minfraud-api-ruby/blob/main/lib/minfraud/components/email.rb#L84)
diff --git a/content/minfraud/proxy-detection.md b/content/minfraud/proxy-detection.md
@@ -14,7 +14,7 @@ environments, we recommend using the
 The proxy detection web service provides a score measuring the risk associated
 with an IP address. It is called the IP risk score in our current minFraud
 services.
-[Learn more about the IP risk score on our knowledge base.](https://support.maxmind.com/hc/en-us/articles/4408382525851-IP-Risk-Score)
+[Learn more about the IP risk score on our knowledge base.](https://support.maxmind.com/knowledge-base/articles/minfraud-ip-risk-score)
 
 ## Release Notes
 
@@ -134,7 +134,7 @@ All strings are returned as ASCII.
             <li>
               `PERMISSION_REQUIRED` – You do not have permission to use the
               service. Please
-              <a href="https://support.maxmind.com/hc/en-us/requests/new"
+              <a href="https://support.maxmind.com"
                 >contact our support team</a
               >
               for more information.
diff --git a/content/minfraud/release-notes/2013.md b/content/minfraud/release-notes/2013.md
@@ -12,7 +12,7 @@ clients. We will be adding AAAA records for hostnames on the dates specified
 below. Most clients aren't yet using IPv6 and should notice no issues. Clients
 with properly configured IPv6 should also notice no issues. If you have any
 questions or issues, please
-[contact our support team](https://support.maxmind.com/hc/en-us/requests/new).
+[contact our support team](https://support.maxmind.com).
 
 The AAAA address for US West servers will be 2607:f0d0:3:7::4.
 
@@ -64,7 +64,7 @@ DNS until the dates specified above, you may begin directing traffic to them now
 if you wish.
 
 If you have any questions please
-[contact our support team](https://support.maxmind.com/hc/en-us/requests/new).
+[contact our support team](https://support.maxmind.com).
 
 List of affected hostnames:
 
diff --git a/content/minfraud/release-notes/2014.md b/content/minfraud/release-notes/2014.md
@@ -20,7 +20,7 @@ In addition, on August 5, we will disable the web services on port 8005 for one
 hour starting at 1pm UTC.
 
 Please
-[contact our support team](https://support.maxmind.com/hc/en-us/requests/new) if
+[contact our support team](https://support.maxmind.com) if
 you have any questions.
 
 {{</ release-note >}}
diff --git a/content/minfraud/release-notes/2019.md b/content/minfraud/release-notes/2019.md
@@ -77,7 +77,7 @@ and unencrypted HTTP requests to MaxMind minFraud services on **October 16,
 error. Please update to TLS 1.2+ to avoid service disruption. You may need to
 upgrade your technology stack to a later version, or make code changes to do so.
 
-[Contact us](https://support.maxmind.com/hc/en-us/requests/new) for support or
+[Contact us](https://support.maxmind.com) for support or
 if you have questions.
 
 {{</ release-note >}}
@@ -150,7 +150,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -188,7 +188,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -227,7 +227,7 @@ requests to legacy minFraud endpoints will fail with an error.
 To avoid service interruption, you may need to upgrade some part of your
 technology stack to a later version, or you may need to make code changes. If
 you have any questions, please do not hesitate to
-[contact us](https://support.maxmind.com/hc/en-us/requests/new). Additional info
+[contact us](https://support.maxmind.com). Additional info
 is available on our
 [blog](https://blog.maxmind.com/2019/04/important-updates-about-tls-v1-0-v1-1-unencrypted-http-requests-and-the-legacy-minfraud-soap-api/).
 
@@ -263,5 +263,5 @@ for more info. {{</ release-note >}}
 security of your MaxMind account, Chrome users can enable two-factor
 authentication (2FA). You can now add and require a (FIDO U2F) security key on
 top of your account credentials for a more secure log-in. See our
-[support center user guide](https://support.maxmind.com/hc/en-us/articles/1260803946470-Set-Up-Two-Factor-Authentication)
+[support center user guide](https://support.maxmind.com/knowledge-base/articles/two-factor-authentication-2fa)
 for information on how to set up 2FA. {{</ release-note >}}
diff --git a/content/minfraud/release-notes/2020.md b/content/minfraud/release-notes/2020.md
diff --git a/content/minfraud/release-notes/2022.md b/content/minfraud/release-notes/2022.md
diff --git a/content/minfraud/release-notes/2023.md b/content/minfraud/release-notes/2023.md
diff --git a/content/minfraud/release-notes/2024.md b/content/minfraud/release-notes/2024.md
diff --git a/content/minfraud/track-devices.md b/content/minfraud/track-devices.md
diff --git a/content/minfraud/working-with-transaction-dispositions.md b/content/minfraud/working-with-transaction-dispositions.md

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`You can`
`2`		`-[learn more about the MaxMind Sandbox on our Knowledge Base](https://support.maxmind.com/hc/en-us/sections/8603980533659-Sandbox-Environment).`
	`2`	`+[learn more about the MaxMind Sandbox on our Knowledge Base](https://support.maxmind.com/knowledge-base/account-and-purchasing#sandbox-environment).`
Original file line number	Diff line number	Diff line change
`@@ -486,7 +486,7 @@ encoding is also referred to as latin1.`
`486`	`486`	`<li>`
`487`	`487`	`<strong>PERMISSION_REQUIRED</strong> – This is returned if you do`
`488`	`488`	`not have permission to use the service. Please`
`489`		`- <a href="https://support.maxmind.com/hc/en-us/requests/new"`
	`489`	`+ <a href="https://support.maxmind.com"`
`490`	`490`	`>contact our support team</a`
`491`	`491`	`>`
`492`	`492`	`for more information.`
Original file line number	Diff line number	Diff line change
@@ -136,7 +136,7 @@ to handle any valid HTTP `4xx` or `5xx` status code.
`136`	`136`	`<td>402 Payment Required</td>`
`137`	`137`	`<td>`
`138`	`138`	`You do not have permission to use the service. Please`
`139`		`- <a href="https://support.maxmind.com/hc/en-us/requests/new"`
	`139`	`+ <a href="https://support.maxmind.com"`
`140`	`140`	`>contact our support team</a`
`141`	`141`	`>`
`142`	`142`	`for more information.`