Hérna finnur þú upplýsingar um hvernig eigi að tengja API fyrir SSG Access.
swagger URI: https://api.ssg.se/swagger/ui/index#/Access
Til að geta prófað API fljótt er "gervi notandi" sem gefur svar sem er þó sama svarið sama hvað þú sendir inn.
ClientID = MockClient
Client Secret = MockClient
Plant
Plant er sá verkstaður sem krefst þess að verktakar (e. Contractors) sem vilja aðgang (e. Access) þurfi að hafa lokið þeim námskeiðum (e. Competence) sem verkstaðurinn setur kröfur (e. Requirements) um. Hér má einnig sjá hvort aðstaðan krefjist þess að fyrirtækið sé skoðað og samþykkt af þjónustuveitunni.
Zone
Zone merkir svæði. Svæði geta haft misjafnar aðgangskröfur og þau geta annað hvort verið innan verkstaðar (þá flokkast svæðið sem innanhúss) og þá hefur það svæði sömu aðgangskröfur og vinnusvæðið sjálft. Svo geta svæði verið utan verkstaðar (þá flokkast það sem ytra) og hefur sínar eigin aðgangskröfur.
Identity
Hægt er að bera kennsl á verktaka með einu eða fleiri auðkennum (e. Identity), svo sem með auðkenni, aðgangskortanúmeri eða Mifare aðgangskortinu.
Contractor
Verktaki er sá einstaklingur sem hefur aðgang (e. Access) að verkstaðnum sem setur aðgangskröfur (e. Plant). Þetta getur innihaldið nafn einstaklingsins, til dæmis.
Company
Verktaki (e. Contractor) getur komið fram fyrir hönd eins eða fleiri verktaka (e. Company). Þetta getur innihaldið nafn fyrirtækis, til dæmis.
Contract
Samningur (e. Contract) samsvarar verkefni sem verktaki hefur verið ráðinn til að sinna.
Competence
Með hæfni (e. Competence) er átt við loknu námskeiði eða áunninni þekkingu (e. Qualification) og inniheldur til dæmis upplýsingar um réttmæti.
Requirement
Krafa (e. Requirement) er það námskeið eða áunninn þekking (e. Qualification) sem verkstaður (e. Plant) fer fram á að verktaki (e. Contractor) hafi til að hann fái aðgang (e. Access).
Qualification
Þekking táknar eitthvað sem verkstaður (e. Plant) gæti krafist (e. Requirement) og sem verktaki (e. Contractor) þarf að uppfylla með hæfni (e. Competence) sinni, svo sem lokið og gilt vefnámskeið frá SSG, eða kunnáttu/þekkingu sem hann hefur aflað á annan hátt. Þetta gæti líka verið vottorð eða leyfi.
Access
Aðgangur (e. Access) er veittur þeim verktökum (e. Contractors) sem uppfylla þær kröfur (e. Requirements) sem verkstaður (e. Plant) setur með því að geta samræmt undirliggjandi þekkingu (e. Qualifications) við samsvarandi þekkingu (e. Competences).
Dæmi
Sækja verktaka byggt á aðgangskortsnúmeri
GET /api/access/v1/contractors/{identity}/{identityType}
identityType = ’SSG’, Identity = Kortnummer 7 siffror
dæmi:
GET /api/access/v1/contractors/1000004/SSG
svar:
{
"Id": "a8501929-e88b-4315-855e-8ac2d1b5****",
"Name": "Lasse Json",
"AccessCardNo": "1000004",
"PhotoUrl": "https://ssgcardissueprod.blob.core.windows.net/cardphotos/89913637-b2a5-4b80-..."
}
Sækja verktaka byggt á kennitölu
GET / api / access / v1 / contractors / {identity} / { identityType }
identityType = STAFF, Identity = Person number
Dæmi:
GET / api / access / v1 / contractors / 671023-XXXX / PERSONAL
Svar:
{
"Id": "a8501929-e88b-4315-855e-8ac2d1b5 ****",
"Name": "Lasse Json",
" AccessCardNo ": "1000004",
" PhotoUrl ": "https://ssgcardissueprod.blob.core.windows.net/cardphotos/89913637-b2a5-4b80-***"
}
Aðgangsstýring
/ api / access / v1 / contractors / { contractorId } / access
contractorId = Id on Contractor, listed in the example above.
Dæmi:
GET / api / access / v1 / contractors / a8501929-e88b-4315-855e-8ac2d1b5 **** / access
Svar:
{
" HasAccess ": true ,
" ValidTo ": "2019-01-28T19: 33: 17.533",
" PlantId ": "ded49d7f-5109-476b-a4de-4fee9ea3 ****",
" ContractorId ": "a8501929-e88b-4315-855e-8ac2d1b5 ****"
}
Eftirlit með fyrirtækjum
/api/access/v1/companies/{companyId}/approved
companyId = Id of company.
Dæmi:
GET /api/access/v1/companies/a8501929-e88b-4315-855e-8ac2d1b5****/approved
Svar:
{
"IsApproved": true,
"PlantId": "ded49d7f-5109-476b-a4de-4fee9ea3****",
"CompanyId": "a8501929-e88b-4315-855e-8ac2d1b5****"
}
Tæknilegar upplýsingar um SSG aðgangskortið.
SSG aðgangskortið hefur fjölbreytta virkni. Hér má finna tæknilegar upplýsingar um kortið.
Kortið sjálft
ISO CR80 Kortið er búið til úr PETG með PVC húðun.
RFID
Em4200
RFID LF: Lág-tíðni, 125kHz, EM4200 (Microelectronic-Marin)
Fyrir utan þennan staðal styðjum við einnig túlkun þessara framleiðenda á EM4200:
- RCO
- Axema
- Soliditet
- Bewator
MIFARE
RFID HF: Hátíðni: 13.56MHz, MIFARE S50 (MIFARE Classic)