Skip to content

singer-io/tap-dixa

Repository files navigation

tap-dixa

This is a Singer tap that produces JSON-formatted data following the Singer spec.

This tap:

Authentication

API token can be retrieved by logging into your Dixa account then going to Settings > Integrations > Configure API Tokens > Add API Token.

Config

The tap accepts the following config items:

field type required description
api_token string yes How to generate an API token
start_date string yes ISO-8601 Example: "2021-08-03" or "2021-08-10T21:24:59.036000+00:00"
interval string no One of the following: "HOUR", "DAY", "WEEK", "MONTH". Default is "MONTH". Interval is used for determing the time interval for the created_after and created_before query string parameters for the conversations and messages streams.

Quick Start

  1. Install

Clone this repository, and then install using setup.py. We recommend using a virtualenv:

$ virtualenv -p python3 venv
$ source venv/bin/activate
$ pip install -e .
  1. Create your tap's config.json file (refer to example config file).

Run the Tap in Discovery Mode This creates a catalog.json for selecting objects/fields to sync:

tap-dixa --config config.json --discover > catalog.json

See the Singer docs on discovery mode here.

NOTE: By default, discovery mode does not "select" any streams or fields to be synced. In order to be synced, each stream and field must contain a selected: true key-value. This is tedious to do by hand but there is this useful tool that provides a CLI GUI to select streams and fields.

  1. Run the Tap in Sync Mode (with catalog) and write out to state file

For Sync mode:

$ tap-dixa --config config.json --catalog catalog.json >> state.json
$ tail -1 state.json > state.json.tmp && mv state.json.tmp state.json

To load to json files to verify outputs:

$ tap-dixa --config config.json --catalog catalog.json | target-json >> state.json
$ tail -1 state.json > state.json.tmp && mv state.json.tmp state.json

To pseudo-load to Stitch Import API with dry run:

$ tap-dixa --config config.json --catalog catalog.json | target-stitch --config target_config.json --dry-run >> state.json
$ tail -1 state.json > state.json.tmp && mv state.json.tmp state.json

NOTE: Running sync mode with a state.json file to resume running from a prior state:

$ tap-dixa --state state.json --config config.json --catalog catalog.json >> state.json
$ tail -1 state.json > state.json.tmp && mv state.json.tmp state.json

Copyright © 2018 Stitch

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages