API » Version 1 » Authorisation

Gets details of the current authenticated user and their assigned personas that permit access to scheme data

Get Authorisation Details GET

Obtains details of the current authenticated user for the supplied authentication token and their assigned personas that permit access to scheme data.

Parameters

Response Parameters
ParameterNameTypeDescription
EntityGUIDEntity GUIDStringUnique identifier for the current user
EntityNameEntity NameString (Optional)The name associated with the current user
UsernameUsernameString (Optional)The unique username assigned to the current user
EmailAddressEmail AddressString (Optional)The email address associated with the current user
AllPersonasAll PersonasEnumeration (Optional)The list of all personas available to the user across all schemes
SchemePersonasScheme PersonasList (Optional)The list of all personas available to the user for individual schemes
SchemeID
Scheme IdentifierNumberThe unique numeric identifier assigned to the scheme
SchemeName
Scheme NameStringThe name of the scheme
Personas
Assigned PersonasEnumerationThe personas available to the user for this scheme

Enumerations

All Personas (Response)
ValueDescription
ManagerUser has scheme manager role
AdministratorUser has scheme administrator role
AuthorUser has standards author role
CertifierUser has certifier administrator role
IndustryUser has scheme industry access
MemberUser is associated with a scheme member
InspectorUser has inspector role
Assigned Personas (Response)
ValueDescription
ManagerUser has scheme manager role
AdministratorUser has scheme administrator role
AuthorUser has standards author role
CertifierUser has certifier administrator role
IndustryUser has scheme industry access
MemberUser is associated with a scheme member
InspectorUser has inspector role

XML

Example Request
GET https://api.casi.services/v1/authorisation.eb HTTP/1.1
Accept: text/xml
Response Schema
<?xml version="1.0" encoding="utf-8"?>
<xsd:schema elementFormDefault="qualified" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="Authorisation">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="EntityGUID" type="xsd:string">
          <xsd:annotation>
            <xsd:documentation>Unique identifier for the current user</xsd:documentation>
          </xsd:annotation>
        </xsd:element>
        <xsd:element name="EntityName" minOccurs="0" type="xsd:string">
          <xsd:annotation>
            <xsd:documentation>The name associated with the current user</xsd:documentation>
          </xsd:annotation>
        </xsd:element>
        <xsd:element name="Username" minOccurs="0" type="xsd:string">
          <xsd:annotation>
            <xsd:documentation>The unique username assigned to the current user</xsd:documentation>
          </xsd:annotation>
        </xsd:element>
        <xsd:element name="EmailAddress" minOccurs="0" type="xsd:string">
          <xsd:annotation>
            <xsd:documentation>The email address associated with the current user</xsd:documentation>
          </xsd:annotation>
        </xsd:element>
        <xsd:element name="AllPersonas" minOccurs="0">
          <xsd:annotation>
            <xsd:documentation>The list of all personas available to the user across all schemes</xsd:documentation>
          </xsd:annotation>
          <xsd:simpleType>
            <xsd:list>
              <xsd:simpleType>
                <xsd:restriction base="xsd:string">
                  <xsd:enumeration value="Manager">
                    <xsd:annotation>
                      <xsd:documentation>User has scheme manager role</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Administrator">
                    <xsd:annotation>
                      <xsd:documentation>User has scheme administrator role</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Author">
                    <xsd:annotation>
                      <xsd:documentation>User has standards author role</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Certifier">
                    <xsd:annotation>
                      <xsd:documentation>User has certifier administrator role</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Industry">
                    <xsd:annotation>
                      <xsd:documentation>User has scheme industry access</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Member">
                    <xsd:annotation>
                      <xsd:documentation>User is associated with a scheme member</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                  <xsd:enumeration value="Inspector">
                    <xsd:annotation>
                      <xsd:documentation>User has inspector role</xsd:documentation>
                    </xsd:annotation>
                  </xsd:enumeration>
                </xsd:restriction>
              </xsd:simpleType>
            </xsd:list>
          </xsd:simpleType>
        </xsd:element>
        <xsd:element name="SchemePersonas" minOccurs="0">
          <xsd:annotation>
            <xsd:documentation>The list of all personas available to the user for individual schemes</xsd:documentation>
          </xsd:annotation>
          <xsd:complexType>
            <xsd:sequence>
              <xsd:element name="Item" minOccurs="0" maxOccurs="unbounded">
                <xsd:complexType>
                  <xsd:sequence>
                    <xsd:element name="SchemeID" type="xsd:double">
                      <xsd:annotation>
                        <xsd:documentation>The unique numeric identifier assigned to the scheme</xsd:documentation>
                      </xsd:annotation>
                    </xsd:element>
                    <xsd:element name="SchemeName" type="xsd:string">
                      <xsd:annotation>
                        <xsd:documentation>The name of the scheme</xsd:documentation>
                      </xsd:annotation>
                    </xsd:element>
                    <xsd:element name="Personas">
                      <xsd:annotation>
                        <xsd:documentation>The personas available to the user for this scheme</xsd:documentation>
                      </xsd:annotation>
                      <xsd:simpleType>
                        <xsd:list>
                          <xsd:simpleType>
                            <xsd:restriction base="xsd:string">
                              <xsd:enumeration value="Manager">
                                <xsd:annotation>
                                  <xsd:documentation>User has scheme manager role</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Administrator">
                                <xsd:annotation>
                                  <xsd:documentation>User has scheme administrator role</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Author">
                                <xsd:annotation>
                                  <xsd:documentation>User has standards author role</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Certifier">
                                <xsd:annotation>
                                  <xsd:documentation>User has certifier administrator role</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Industry">
                                <xsd:annotation>
                                  <xsd:documentation>User has scheme industry access</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Member">
                                <xsd:annotation>
                                  <xsd:documentation>User is associated with a scheme member</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                              <xsd:enumeration value="Inspector">
                                <xsd:annotation>
                                  <xsd:documentation>User has inspector role</xsd:documentation>
                                </xsd:annotation>
                              </xsd:enumeration>
                            </xsd:restriction>
                          </xsd:simpleType>
                        </xsd:list>
                      </xsd:simpleType>
                    </xsd:element>
                  </xsd:sequence>
                </xsd:complexType>
              </xsd:element>
            </xsd:sequence>
          </xsd:complexType>
        </xsd:element>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>
Example Response
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Authorisation>
  <EntityGUID>xsd:string</EntityGUID>
  <EntityName>xsd:string</EntityName>
  <Username>xsd:string</Username>
  <EmailAddress>xsd:string</EmailAddress>
  <AllPersonas>xsd:string</AllPersonas>
  <SchemePersonas>
    <Item>
      <SchemeID>xsd:double</SchemeID>
      <SchemeName>xsd:string</SchemeName>
      <Personas>xsd:string</Personas>
    </Item>...</SchemePersonas>
</Authorisation>

JSON

Example Request
GET https://api.casi.services/v1/authorisation.eb HTTP/1.1
Accept: application/json
Example Response
HTTP/1.1 200 OK
Content-Type: application/json

{"EntityGUID":String,
  "EntityName":String,
  "Username":String,
  "EmailAddress":String,
  "AllPersonas":String,
  "SchemePersonas":[{"SchemeID":Number,
      "SchemeName":String,
      "Personas":String},
    ...]}

Test