Tech Partners: DDx Exchange as a Destination

Overview

This section covers information about Interactions API requests with the DDx Exchange's endpoint as a destination for Interactions API data.

Interactions App

Check out our Set Up for Sources section if you do not already have an Interactions API App required for sending data to the DDx Exchange.

Validating DDx API Key configuration

The /v1/auth/me endpoint enables two things:

1. Confirmation that you're using your API key correctly and can authenticate to the API
2. The ability to confirm the API Key's associated Workspace, Source and Destination details.

Additional API Request Validation

Interactions API requests using an API key configured with DDx Exchange as a Destination are subjected to additional validation. This includes:

1. To be assessed for credits, currently the person array must include at least one object with type of dwid, voterbase_id, smartvan_vanid, votebuilder_vanid or av_vanid. These types must be submitted as dwid, voterbase_id, smartvan_vanid, votebuilder_vanid or av_vanid or they will be considered unsupported.
2. All survey response outcomesDetailed objects (indicated by the "survey_response" type) must include questionId and responseId. These must be valid VAN survey question and response IDs and must be integers if Exchange is a Destination.
3. All survey response outcomesDetailed objects (indicated by the "survey_response" type) must include questionText and responseText. These should be the full text of the question and response, respectively.
4. All event signup outcomesDetailed objects (indicated by the "event_signup" type) must include eventId object
   and status object with valid status.

An example of a valid request can be found on the API Examples page (Scenario 3).

How is data mapped to the DDx Exchange schema?

The table below describes how data on the Interactions API request is mapped to the format accepted by the DDx Exchange. Currently, language and is_cell fields are not supported and will always be reported to the Exchange as null.

Dispositions

Survey Responses

Survey Response Metadata

Fetching DDx Exchange transactional logs

Status and logs regarding integration with the DDx Exchange can be fetched two ways:

1. By date, using the endpoint described here.
2. By interactionId, which can be found in successful POST /interactions responses, using the endpoint described here.