Show Access Levels

GET /Api/Read/Acl
Authorization key & Authorization date & Authorization hmac

This process returns the endpoints that your acl allows you to call. Note that API Access Control Lists are always manually created by a StrandVision system administrator. Secret Hmac Required. Cache Time 1 Hour. Reset if key edited.

Responses

  • 200

    ACL list successfully returned

    Hide response attributes Show response attributes array[object]
    • Path string

      The path that is allowed (* = wildcard from that level on)

    • Display_Name string

      A text representation of what the endpoints can do.

    • Id number

      database id for this ACL (useful for reviewing logs)

    • Is_Public number

      1 if this is publicly available, 0 if not

    • Require_Https number

      1 if requires https, 0 if http is allowed.

    • Require_Hash number

      0 for no date checksum required. 1=md5, 2=sha1, 3=sha256, 4=sha384, 5=sha512 hash of the date is required. The encryption method can be overridden by the api key.
GET /Api/Read/Acl 
curl \
 -X GET https://Api.StrandVision.com/v1.0/Api/Read/Acl \
 -H "Authorization: X-apikey $ACCESS_TOKEN" \
 -H "Authorization: X-apidate $ACCESS_TOKEN" \
 -H "Authorization: X-apihmac $ACCESS_TOKEN"
Response examples (200) 
[
  {
    "Path": "api/Read/*",
    "Display_Name": "Read API access information",
    "Id": 1,
    "Is_Public": 1,
    "Require_Https": true,
    "Require_Hash": "None"
  },
  {
    "Path": "people/Read/*",
    "Display_Name": "Allows access to read people endpoints",
    "Id": 100,
    "Is_Public": 0,
    "Require_Https": 1,
    "Require_Hash": "Sha256"
  }
]
Response examples (200) 
[
  {
    "Path": "/Api/Read/*",
    "Display_Name": "public access to api read endpoints",
    "Id": 1,
    "Is_Public": 1,
    "Require_Https": 1,
    "Require_Hash": 3
  }
]