README.md

Confetti API documentation

Confetti uses a GraphQL API. The GraphQL endpoint is available at:

https://confetti-app.dev/graphql

You can explore the API using the [sandbox]:

https://confetti-app.dev/sandbox

For an example, the following query (used in the screenshot above) returns the 100 first sessions:

query {
  sessions(first: 100) {
    nodes {
      id
      title
      speakers {
        name
      }
    }
  }
}

Choosing your conference

The API uses the value of the "conference" HTTP header to return data for a specific conference:

To get a list of available conferences at a given point in time, use the root conferences field:

query {
  conferences {
    id
    name
  }
}

Authentication

Setting and reading bookmarks requires to be authenticated. Authentication is handled through Firebase authentication. Retrieve an id token with Firebase.auth.currentUser?.getIdToken() and pass it in your "Authorization" headers:

Authorization: Bearer ${firebaseIdToken}

Contributing

For details how to run the backend locally and/or deploy, see CONTRIBUTING.md