Spaces
Wat een Space is en welke velden hij heeft.
Een Space is de werkruimte voor één klant van je kantoor in Tibata.
Velden
| Veld | Betekenis |
|---|---|
id | Uniek ID van de Space. Je gebruikt het in elke andere aanroep over deze Space. |
name | Naam van de Space, uniek binnen je organisatie. |
slug | URL-vriendelijke naam, uniek binnen je organisatie. Laat je hem weg, dan leidt Tibata hem af van de naam. |
description | Optionele korte omschrijving. |
url | Link naar de Space in Tibata. |
restricted | true 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.
| Verzoek | Met een rol in de Space | Zonder rol |
|---|---|---|
GET /v1/spaces | Vermeld met al zijn velden, restricted op true | Vermeld met alleen id, name en restricted |
GET /v1/spaces/{space_id} | Teruggegeven, restricted op true | Mislukt 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:
| Verzoek | Rol 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 verwijdert | Kan 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.