From 29f22915b1972c934ff1df78f54e086d24b74cc9 Mon Sep 17 00:00:00 2001 From: genwhittTTD Date: Tue, 10 Feb 2026 15:34:41 -0500 Subject: [PATCH 1/2] gwh-APIDOCS-3690-03-fix-broken-links --- docs/getting-started/gs-normalization-encoding.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index 7e63db007..802d676f1 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -194,7 +194,7 @@ You can use this tool to verify that your internal processes are set up to corre ## Troubleshooting -In all scenarios, follow the steps on your side to prepare your DII for processing, and then check your resulting values by using the [UID2 Hashing Tool](#uid2-hashing-tool). If the results don't match, check each step to find the error. +In all scenarios, follow the steps on your side to prepare your DII for processing, and then check your resulting values by using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). If the results don't match, check each step to find the error. If you're having trouble or getting errors, or if you just want to be sure you're following the steps correctly, here are some things you can check: @@ -202,8 +202,8 @@ If you're having trouble or getting errors, or if you just want to be sure you'r The service normalizes emails, but it can't normalize phone numbers. For example, it can't determine the value for a missing country code. Use these resources: - Instructions: [Phone Number Normalization](#phone-number-normalization). - - Tool for cross-checking: [UID2 Hashing Tool](#uid2-hashing-tool). + - Tool for cross-checking: [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). - **Use the Base64-encoded value**: The process includes normalizing, then hashing, then Base64-encoding the bytes of the hash value. When generating UID2s, the input is the Base64-encoded value. Make sure you're using this 44-character string value. -- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email Address Hash Encoding](#email-address-hash-encoding) or [Phone Number Hash Encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 Hashing Tool](#uid2-hashing-tool). \ No newline at end of file +- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email Address Hash Encoding](#email-address-hash-encoding) or [Phone Number Hash Encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). \ No newline at end of file From 972b140e9994151acbb39b2fe25adcbc011415cc Mon Sep 17 00:00:00 2001 From: genwhittTTD Date: Tue, 10 Feb 2026 15:44:59 -0500 Subject: [PATCH 2/2] gwh-APIDOCS-3690-03-fix-broken-links --- docs/endpoints/post-identity-map.md | 2 +- docs/ref-info/glossary-uid.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/endpoints/post-identity-map.md b/docs/endpoints/post-identity-map.md index d9ba3e11e..696e9f239 100644 --- a/docs/endpoints/post-identity-map.md +++ b/docs/endpoints/post-identity-map.md @@ -176,7 +176,7 @@ For successfully mapped DII, the mapped object includes the properties shown in |:---------|:-----------|:--------------------------------------------------------------------------------------------------------------------------------------| | `u` | string | The raw UID2 corresponding to the email or phone number provided in the request. | | `p` | string | One of the following: | -| `r` | number | The Unix timestamp (in milliseconds) that indicates when the raw UID2 might be refreshed. The raw UID2 is guaranteed to be valid until this timestamp. | +| `r` | number | The Unix timestamp (in milliseconds) that indicates when the raw UID2 might be refreshed. The raw UID2 is valid until this timestamp. | :::note The raw UID2 does not change before the refresh timestamp. After the refresh timestamp, remapping the DII returns a new refresh timestamp, but the raw UID2 might or might not change. It is possible for the raw UID2 to remain unchanged for multiple refresh intervals. diff --git a/docs/ref-info/glossary-uid.md b/docs/ref-info/glossary-uid.md index 0d51e6db9..f5eeebd59 100644 --- a/docs/ref-info/glossary-uid.md +++ b/docs/ref-info/glossary-uid.md @@ -402,7 +402,7 @@ import MdxJumpAnchor from '@site/src/components/MdxJumpAnchor';
For details, see UID2 Identifier Types.
Refresh timestamp
-
In the context of mapping DII to raw UID2s, a refresh timestamp is a Unix timestamp (in seconds) returned in the r field of the POST /identity/map endpoint response. The raw UID2 is guaranteed to be valid until this timestamp. It is refreshed at some point after this time.
+
In the context of mapping DII to raw UID2s, a refresh timestamp is a Unix timestamp (in seconds) returned in the r field of the POST /identity/map endpoint response. The raw UID2 is valid until this timestamp. It is refreshed at some point after this time.
Use the refresh timestamp to determine when to regenerate raw UID2s for your stored data. We recommend checking for refresh opportunities daily by comparing the current time with the stored refresh timestamps.
Refresh token