This thin API layer is used to store POSTed payloads to the main storage system of Open Podcast.

• Run make install-init
• Start dev server with make dev
• Create .env file based on env.example and change the credentials to access the database. For a docker compose setup have a look at https://github.com/openpodcast/stack
• In a new window, run e.g. make send-api-req-local to send a test request to the local dev server (result is stored to DB).

{
    "provider": "spotify",
    "version": 1,
    "retrieved": "<timestamp ISO 8601>", //2022-07-21T09:35:31.820Z
    "meta": {
        "show": "<spotify_show_id>",
        "episode": null || "<episode_id>",
        "endpoint": "<endpoint_name>", // e.g. aggregate
    },
    "range": {
        "start": "<date>", //2022-01-01
        "end": "<date>"
    },
    "data": <raw_json>
}

The feedback API retrieves thumbs up/down votes from listeners. It stores one unique vote for each episode per IP and user-agent pair.

Endpoint /feedback/:episodeID/[upvote|downvote] e.g. /feedback/123456/upvote

The status API returns the last imports by endpoint:

{
    "account_id": 1,
    "latestUpdates": [
        "aggregate": "2021-01-01 00:00:00"
        "detailedStreams": "2021-01-01 00:00:00"
    ]
}

To query it, use the following endpoint: /status

• https://transform.tools/json-to-json-schema
• https://jsoning.com/jsonschema/

Run all tests:

make test               # Unit tests
make e2e-tests          # End-to-end tests incl setup of stack

Run a specific test by name, dev and db server must be running:

make test-one-e2e-"test name here"

For example, to run only the authentication test:

make test-one-e2e-"should return not be authenticated with random token"

• make up-db starts the db and inits basic auth related tables
• make dev starts the dev server which also creates the tables using migrations
• to finalize the auth data run make init-auth-db which creates the auth structures