AdminResource Resource

Resource for various tasks used by the administrator (like retrieving version numbers)

GET /admin/publicKey

Get the public server key as JWK

Response Codes
code condition
200 Public Key is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json object (JSON) Public server key as JWK

Example

Request
GET /admin/publicKey
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "kty" : "RSA",
  "e" : "AQAB",
  "use" : "sig",
  "kid" : "a9eb8baa-801e-4802-be20-f04aeda1efa0",
  "n" : "6UiLZTzmDC1tAVh0hdA3yGx1eLAc5Ybg9ClgeJk1cZn-OzTHZCT5GT58UF1y4AR-dMqqLybzOTvV-BdwVcLh92S1p_mpl-1rZOSsdATDuwH72EpLg5dSvTq520Ju3MbBJn_JkZWVRkhWBctRR6W0qWYkK8ecg67knKzOwOng8z3IRISOgPSZ3JS0eaZzSIfRnqIvh5ZBt3AuX-P0QH_S9FQYUqD2lY7OoRDPtCeCVaDi5blZPT_X_u0M1n0qJdw1MjPIIJJzeJmKslxBuenHPqlpuofZ9s53VJ2dqkB--UA5k2XTUUwrhoKhYBhV3pdaCPIiIWTmCN2kweHrPJ14mw"
}
                
              

GET /admin/publishInfo

Get information of the current publish process

Response Codes
code condition
200 Requested data is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json PublishInfoResponse (JSON) publish info response

Example

Request
GET /admin/publishInfo
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "failed" : false,
  "progress" : 38,
  "estimatedDuration" : 128,
  "running" : true,
  "totalWork" : 1325,
  "totalWorkDone" : 503,
  "phase" : "...",
  "files" : {
    "toPublish" : 158,
    "delayed" : 0,
    "published" : 22,
    "remaining" : 136
  },
  "folders" : {
    "toPublish" : 158,
    "delayed" : 0,
    "published" : 22,
    "remaining" : 136
  },
  "pages" : {
    "toPublish" : 158,
    "delayed" : 0,
    "published" : 22,
    "remaining" : 136
  },
  "messages" : [ { }, { } ],
  "responseInfo" : {
    "responseCode" : "OK",
    "responseMessage" : "...",
    "property" : "..."
  }
}
                
              

GET /admin/tools

Get the tools, that shall be shown in the UI

Response Codes
code condition
200 Requested data is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json ToolsResponse (JSON) list of tools

Example

Request
GET /admin/tools
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "tools" : [ {
    "id" : 12345,
    "key" : "...",
    "name" : {
      "property1" : "...",
      "property2" : "..."
    },
    "toolUrl" : "...",
    "iconUrl" : "...",
    "newtab" : true
  }, {
    "id" : 12345,
    "key" : "...",
    "name" : {
      "property1" : "...",
      "property2" : "..."
    },
    "toolUrl" : "...",
    "iconUrl" : "...",
    "newtab" : true
  } ],
  "messages" : [ { }, { } ],
  "responseInfo" : {
    "responseCode" : "OK",
    "responseMessage" : "...",
    "property" : "..."
  }
}
                
              

GET /admin/updates

Get available updates

Response Codes
code condition
200 Requested data is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json UpdatesInfoResponse (JSON) response containing available updates

Example

Request
GET /admin/updates
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "available" : [ "5.34.23", "5.35.6" ],
  "messages" : [ { }, { } ],
  "responseInfo" : {
    "responseCode" : "OK",
    "responseMessage" : "...",
    "property" : "..."
  }
}
                
              

GET /admin/version

Get the current version of the REST API on the server

Response Codes
code condition
200 Requested data is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json VersionResponse (JSON) VersionResponse

Example

Request
GET /admin/version
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "version" : "5.35.6",
  "messages" : [ { }, { } ],
  "responseInfo" : {
    "responseCode" : "OK",
    "responseMessage" : "...",
    "property" : "..."
  }
}
                
              

GET /admin/features/{name}

Get info about a feature activation

Request Parameters
name type description
name path name of the feature
Response Codes
code condition
200 Requested data is returned.
401 No valid sid and session secret cookie were provided.
403 User has insufficient permissions.
Response Body
media type data type description
application/json FeatureResponse (JSON) feature response

Example

Request
GET /admin/features/new_tageditor
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "name" : "new_tageditor",
  "activated" : true,
  "messages" : [ { }, { } ],
  "responseInfo" : {
    "responseCode" : "OK",
    "responseMessage" : "...",
    "property" : "..."
  }
}