Groups

Guardian Groups Endpoints.

Groups

/groups

GET https://explorer.protokol.sh/api/guardian/groups

Returns all Groups

Query Parameters

NameTypeDescription

page

integer

The number of a page that will be returned

limit

integer

The number of resources per page

orderBy

string

Type by which it should order resources. Example: orderBy=name:asc

name

string

Value by which it should search for resources (allows wildcard %)

priority

integer

Value by which should search for resources

active

boolean

Value by which should search for resources

default

boolean

Value by which should search for resources

{
  "meta": {
    "totalCountIsEstimate": false,
    "count": 2,
    "pageCount": 1,
    "totalCount": 2,
    "next": null,
    "previous": null,
    "self": "/guardian/groups?page=1&limit=100",
    "first": "/guardian/groups?page=1&limit=100",
    "last": "/guardian/groups?page=1&limit=100"
  },
  "data": [
    {
      "name": "Test Guardian Permission Group",
      "priority": 1,
      "active": true,
      "default": false,
      "allow": [
        {
          "transactionType": 1,
          "transactionTypeGroup": 1
        }
      ],
      "deny": [
        {
          "transactionType": 2,
          "transactionTypeGroup": 1
        }
      ]
    },
    {
      "name": "Test Guardian Permission Group2",
      "priority": 1,
      "active": true,
      "default": false,
      "allow": [
        {
          "transactionType": 1,
          "transactionTypeGroup": 1
        }
      ],
      "deny": [
        {
          "transactionType": 2,
          "transactionTypeGroup": 1
        }
      ]
    }
  ]
}

Examples

curl https://explorer.protokol.sh/api/guardian/groups

Group By Name

/groups/:name

GET https://explorer.protokol.sh/api/guardian/groups/:name

Returns Group by name

Path Parameters

NameTypeDescription

name

string

The name of the group

{
  "data": {
    "name": "Test Guardian Permission Group",
    "priority": 1,
    "active": true,
    "default": false,
    "allow": [
      {
        "transactionType": 1,
        "transactionTypeGroup": 1
      }
    ],
    "deny": [
      {
        "transactionType": 2,
        "transactionTypeGroup": 1
      }
    ]
  }
}

Examples

curl https://explorer.protokol.sh/api/guardian/groups/Test%20Guardian%20Permission%20Group

Users By Group Name

/groups/:name/users

GET https://explorer.protokol.sh/api/guardian/groups/:name/users

Returns users of specific group by name

Path Parameters

NameTypeDescription

name

string

The name of the group

{
  "data": [
    {
      "publicKey": "03c11f2a1fc02c88cd9b8db5272cba390bdb9ce3e1d58355de1b7a24c673e06ebc",
      "groups": [
        "Test Guardian Permission Group"
      ],
      "allow": [
        {
          "transactionType": 2,
          "transactionTypeGroup": 1
        }
      ],
      "deny": []
    }
  ]
}

Examples

curl https://explorer.protokol.sh/api/guardian/groups/Test%20group%201/users

Last updated