En kategori har tre identiteter. Alle tre peker pÄ det samme.

IdentitetEksempelBruk
KlassenavnOfficeChairKortformen i API-kall. Engelsk, stabil.
URIhttp://taxonomy.sirktek.no/furniture#OfficeChairFullt 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=OfficeChair

URI

URI-en er klassenavnet med taksonomiens navnerom foran:

http://taxonomy.sirktek.no/furniture#OfficeChair

API-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