Identifikatorer
En kategori har tre identiteter. Alle tre peker pÄ det samme.
| Identitet | Eksempel | Bruk |
|---|---|---|
| Klassenavn | OfficeChair | Kortformen i API-kall. Engelsk, stabil. |
| URI | http://taxonomy.sirktek.no/furniture#OfficeChair | Fullt navn. Entydig pÄ tvers av taksonomier. |
| Numerisk ID | -907692052 (for Chair) | NĂžkkelen i data. Alltid negativ for felleskategorier. |
Klassenavn
Klassenavnet er engelsk og skrives i PascalCase: Chair, OfficeChair, CabinetUnit.
Det norske navnet, for eksempel «Kontorstol», er visningstekst. Bruk aldri
visningsteksten som nĂžkkel.
I API-kall kan du bruke klassenavnet direkte:
GET /solutions?category=OfficeChairURI
URI-en er klassenavnet med taksonomiens navnerom foran:
http://taxonomy.sirktek.no/furniture#OfficeChairAPI-et godtar URI-en overalt der det godtar klassenavnet. Bruk URI-en nÄr du trenger Ä vÊre helt entydig pÄ tvers av taksonomier.
Numerisk ID
Hver kategori har en numerisk ID. Den regnes ut deterministisk fra URI-en med en hash. Samme URI gir samme ID, i alle tjenester og til enhver tid.
To regler er verdt Ă„ huske:
- Felleskategorier har negativ ID. For eksempel
Chair=-907692052. - Organisasjonens egne kategorier har positiv ID. De kommer fra databasen.
ID-ene er trygge i JavaScript. De holder seg innenfor Number.MAX_SAFE_INTEGER.
Det er den numeriske ID-en som stÄr i data: pÄ objekter, pÄ tjenester og pÄ ordrelinjer. Klassenavn og URI er oppslagsnÞkler inn til den.
Videre
- TjenestesĂžk. Kategorien i praksis.