Create
This endpoint can be used to create a new URL configuration that can then be programmed into multiple tags.
Defining the URL
A custom URL can be defined by writing out your URL and wrapping 4 of the required parameters in curly braces ”{}“.
Custom URL Params
- tagId - The ETRNL unique ID of the tag
- enc - The encrypted message generated by the tag
- cmac - he CMAC integrity data generated by the tag (Only required if tamper detection is not enabled)
- tt - The encrypted tag tamper status generated by the tag. (Only required if tamper detection is enabled)
- eCode - A KDF input parameter used for key decyrption
Examples
https://exmaple.com/{tagId}/?enc={enc}&cmac={cmac}&eCode={eCode}
The custom URL params can only be used as a query parameter, or a URL slug.
Tag Tamper
For tag tamper URLs, you cannot include the cmac value as the tt message includes both the cmac and the encrypted tamper status.
So the custom URL would look something like:
https://exmaple.com/{tagId}/?enc={enc}&tt={tt}&eCode={eCode}
Headers
Your organization’s private API key.
JSON Request Body
The name of your custom URL group.
The custom URL definition that will be programmed into the tags.
This is the service that’s used to add the custom URL. The custom URL group will show up in the programmer as [APP Name] - Name.