Naar inhoud springen
Tibata
Docs

Quickstart

Je eerste API-aanroep in vijf minuten. Maak een client aan, haal een access token op en vraag de Spaces van je organisatie op.

Na deze vijf minuten zie je de Spaces van je organisatie als JSON in je terminal.

Wat je nodig hebt

  • De rol Eigenaar of Beheerder in je Tibata-organisatie.
  • Een terminal.

Client aanmaken

  1. Open in Tibata het gebruikersmenu rechtsboven en kies API instellingen.
  2. Klik op Nieuwe client…, vul een Naam in en selecteer onder Scopes alleen spaces.read.
  3. Klik op Client aanmaken.

De melding Sla je client secret op toont het client ID en secret. Het secret zie je maar één keer, dus kopieer beide voordat je op Ik heb het secret opgeslagen klikt. Authenticatie beschrijft elk veld.

Credentials bewaren

Zet het client ID en secret in omgevingsvariabelen, zodat de volgende commando's ze gebruiken:

export TIBATA_CLIENT_ID="<client-id>"
export TIBATA_CLIENT_SECRET="<client-secret>"

Access token ophalen

curl -X POST https://auth.tibata.ai/api/auth/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  --data-urlencode "client_id=$TIBATA_CLIENT_ID" \
  --data-urlencode "client_secret=$TIBATA_CLIENT_SECRET" \
  -d "scope=spaces.read" \
  -d "resource=https://api.tibata.ai/"

Het antwoord bevat het access token:

{
  "access_token": "eyJhbGci...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "spaces.read"
}

Zet de waarde van access_token in een omgevingsvariabele:

export TIBATA_TOKEN="<access-token>"

Spaces opvragen

curl https://api.tibata.ai/v1/spaces \
  -H "Authorization: Bearer $TIBATA_TOKEN"

Je krijgt de Spaces van je organisatie terug, gesorteerd op naam:

{
  "data": [
    {
      "id": "tB6gszM_JPk7vKaHfz1H4",
      "name": "Space 1",
      "slug": "space-1",
      "description": "Space 1 description",
      "url": "https://app.tibata.ai/o/my-org/space-1"
    },
    {
      "id": "uC7htzN_KQl8wLbIgy2I5",
      "name": "Space 2",
      "slug": "space-2",
      "description": null,
      "url": "https://app.tibata.ai/o/my-org/space-2"
    }
  ]
}

Een lege lijst betekent dat je organisatie nog geen Spaces heeft.

Volgende stappen

Om Spaces aan te maken heeft je client ook spaces.write nodig; om ze aan een administratie te koppelen integrations.read en integrations.write. Voeg ze toe via Scopes bewerken… in de rij van de client.

Op deze pagina