By migrating to Survalyzer NG there are several adaptions necessary. Even with the major release of Survalyzer our APIs remain stable from a structural perspective with two exceptions:
- The API endpoint doesn’t contain the tenant any longer, therefore it is necessary to handover the tenant in the GetApiToken method as parameter.
- The request parameters language and status, which were already obsolete in Classic were finally removed.
Beside these two breaking changes there are only non breaking changes in downloading raw data:
Classic | NG | Change | Description |
---|---|---|---|
CID | – | Removed | This was the primary index in classic which should have never been exposed. It was replaced with InterviewId. |
– | InterviewId | Added | Unique identifier (GUID) for an interview. |
Panel | – | Removed | The name of the panel was not unique and wasn’t meaningful from an API perspective. It has been replaced with PanelId. |
– | PanelId | Added | Unique identifier (Number) for a Panel. |
– | UrlVar01 – UrlVar20 | Added | Url Variables are added for the sake of completeness |
ResponseCreated | InterviewCreationDate | Changed | For the sake of consistency this field has been renamed. |
ResponseStart | InterviewStartDate | Changed | |
ResponseFinished | InterviewEndDate | Changed | |
Duration | InterviewDuration | Changed | |
Status | InterviewState | Changed | |
ResponseLanguage | InterviewLanguage | Changed | |
{member field} | member.{member field} | Changed | To avoid conflicts between survey variables and question variables the “member.” prefix has been introduced. |
{custom variable} | custom.{custom variable} | Changed | To avoid conflicts between question, member and custom variables the “custom.” prefix has been introduced. |
UserAgent | – | Removed | The unstructured and inhomogeneous field has been removed in favor of the individual structured fields |
– | BrowserLanguage | Added | |
– | BrowserName | Added | |
– | BrowserVersion | Added | |
– | BrowserWindowSize | Added | |
– | Encoding | Added | |
– | OperatingSystemName | Added | |
– | OperatingSystemVersion | Added | |
– | ScreenColors | Added | |
– | ScreenResolution | Added | |
– | DevicePixelRatio | Added | |
– | TimezoneOffset | Added |
These naming changes are resolving the issues of Classic which were related to variable conflicts and ambiguity. This mapping table shall help with the API migration from Classic to NG without try / fail iterations.
Additional to the mentioned changed also the license model changed. If you are currently in the Essential license model you are no longer entitled to use the API. In this case please contact Sales to get an appropriate license.