Zum Inhalt springen

IZI API for Developers — Overview

Опубликовано: · Обновлено: (1 месяц назад)· IZI Team

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

IZI exposes a GraphQL API — the same API that IZI CRM and the player app work through. The sections below describe how it is reached, how a club employee gets a token, and what errors look like.

  • Gaming Club Software Overview
  • Shift Management in IZI
  • IZI Tariff Configuration

Häufig gestellte Fragen

What protocol does the IZI API use?

IZI uses GraphQL over HTTPS. All queries and mutations go to a single /graphql endpoint on the API host of your contour, and you shape the response to include only the fields your integration needs.

How do I authenticate with the IZI API?

A club employee obtains a token via the loginWithEmailPassword mutation, then passes it in the Authorization header as a Bearer token on every subsequent request. There is no separate API key or service account.

What data can I read through the IZI API?

Without a token, only the public catalog: clubs, zones, tariffs, products and promotions. Everything else is available with a club employee (CRM) or player (PLAYER) token, within the rights of that user.

Can I write data back through the API, or is it read-only?

The API supports both queries (read) and mutations (write). Which mutations a token may call is defined by the role and permissions of the user it was issued to.

Does IZI provide an SDK or code examples?

There is no official SDK. The SDK Examples section has JavaScript and Python wrappers covering sign-in and common queries.

How do I integrate IZI with CloudPayments?

IZI has a built-in CloudPayments integration. The CloudPayments Integration guide covers provider setup, the IZI addresses CloudPayments calls, and the player payment flow.

What HTTP status codes does the IZI API return?

Business errors come back with HTTP 200 and a code in errors[].extensions.code. The Error Codes page explains the error format and the most common codes.

Where do I start if I am new to the IZI API?

Start with the API Overview to understand the architecture, then follow the Authentication guide to get a working token. After that, explore the GraphQL Basics page to run your first query.

About IZI