Naar inhoud springen
Tibata
Docs

Spaces

Wat een Space is en welke velden hij heeft.

Een Space is de werkruimte voor één klant van je kantoor in Tibata.

Velden

VeldBetekenis
idUniek ID van de Space. Je gebruikt het in elke andere aanroep over deze Space.
nameNaam van de Space, uniek binnen je organisatie.
slugURL-vriendelijke naam, uniek binnen je organisatie. Laat je hem weg, dan leidt Tibata hem af van de naam.
descriptionOptionele korte omschrijving.
urlLink naar de Space in Tibata.
restrictedtrue als de algemene toegang van de Space Geen toegang is: hij gaat alleen open voor de mensen en clients die hij noemt. Ook als het false is, kan een wijziging een rol in de Space vragen; zie Spaces die niet elk lid kan bewerken.

Standaardprojecten

Zet applyProjectDefaults op true bij het aanmaken van een Space om hem de standaardprojecten van je organisatie mee te geven. De vlag geldt alleen bij het aanmaken; de Space bewaart hem niet. Bevat je abonnement geen projecten, dan mislukt het verzoek met 403 en de code NOT_ENTITLED.

Beperkte Spaces

Een Space is beperkt als de algemene toegang in Tibata Geen toegang is: alleen de mensen en clients die hij noemt, kunnen hem openen. Om hem te lezen is een rol in de Space nodig: een client-credentials-token heeft de rol nodig die zijn client heeft gekregen, een token dat voor een gebruiker is uitgegeven de rol van die gebruiker.

VerzoekMet een rol in de SpaceZonder rol
GET /v1/spacesVermeld met al zijn velden, restricted op trueVermeld met alleen id, name en restricted
GET /v1/spaces/{space_id}Teruggegeven, restricted op trueMislukt met 403, de code FORBIDDEN en de reden ROLE_REQUIRED

Spaces die niet elk lid kan bewerken

Voor wijzigingen geldt een ruimere regel. Kan niet elk lid een Space bewerken, omdat de algemene toegang Kan bekijken of Geen toegang is, dan vraagt een wijziging een rol in de Space, ook al is restricted bij Kan bekijken false:

VerzoekRol nodig in een Space die niet elk lid kan bewerken
PATCH /v1/spaces/{space_id}Kan bewerken of Kan beheren
PUT /v1/integrations/connections/{connection_id}/mappings, als het een mapping van de Space toevoegt of verwijdertKan bewerken of Kan beheren

DELETE /v1/spaces/{space_id} vraagt altijd Kan beheren in de Space, wat de algemene toegang ook is. Een token dat voor een gebruiker is uitgegeven, vraagt ook dat die gebruiker beheerder of eigenaar van de organisatie is.

Een client-credentials-token heeft de rol nodig die zijn client heeft gekregen; een token dat voor een gebruiker is uitgegeven, de rol van die gebruiker. Zonder die rol mislukt het verzoek met 403, de code FORBIDDEN en de reden ROLE_REQUIRED, en verandert er niets. Een Space aanmaken vraagt geen rol, en een Space lezen alleen als hij beperkt is. In een Space op Kan bewerken (de standaard) vraagt alleen verwijderen een rol in de Space zelf.

Een Space koppelen

Een Space is op zichzelf niet aan een administratie gekoppeld. Integraties legt uit hoe je hem aan Exact Online, Twinfield of SharePoint koppelt.

Op deze pagina