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

1KB

google-jwt-generator.zip

archive

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"

Use your Tailer identity instead

You can use the identity provided when you installed your tailer-sdk:

tailer auth get-token | awk '/User token :/ {print $4}'

You can use this to get your JWT token:

TAILER_API_JWT=`tailer auth get-token | awk '/User token :/ {print $4}'` \
&& 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"