Getting started

To use the Tailer API, you first need to generate a JWT token from Google credentials in order to authenticate. Then you can send a first POST request to it using cURL.

​🔐 Generate a JWT token from Google credentials

To generate a Google JWT token:

  1. Download and unzip the ZIP file above. You get a Python file named "google-jwt-generator.py".

  2. Generate a Google JSON credentials file (see Generate JSON credentials).

  3. Run the following script using Python:

    python3 google-jwt-generator.py your-credentials.json
  4. You can save the token in a shell variable:

    TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json`

​1 Send a first request to the Tailer API

To communicate with the Tailer API, you can use the cURL CLI.

Here is an example of request allowing you to check the status of a Tables to Tables data operation run:

TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
"account": "000099",
"environment": "DEV",
"configuration_type": "table-to-table",
"configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
"job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
"run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"