WossiDiA-PowerGraph - API


Version 0.4.32 (2025-03-31 02:26)


ReturnsPathDescriptionRequest Parameters
text/html/Prints an overview of all API functions.
application/json/catalogReturns the entire WossiDiA-PowerGraph catalog.types, sup, inf, exp, inheritedAttrs, inheritedRoles
application/json/catalog/datatypesReturns all WossiDiA-PowerGraph datatypes.
application/json/catalog/datatype/{dataType}Returns a specific datatype.
application/json/catalog/nodetypesReturns all WossiDiA-PowerGraph node types.sup, inf, inheritedAttrs
application/json/catalog/nodetype/{nodeType}Returns the specified WossiDiA-PowerGraph node type.sup, inf, inheritedAttrs
application/json/catalog/edgetypesReturns all WossiDiA-PowerGraph edge types.sup, inf, exp, inheritedAttrs, inheritedRoles
application/json/catalog/edgetype/{edgeType}Returns the specified WossiDiA-PowerGraph edge type.sup, inf, exp, inheritedAttrs, inheritedRoles
application/json/nodes/{type}Obtains all nodes of the specified type.
application/json/nodes/{type}/{cond}Obtains nodes of the specified type with the specified condition.
application/json/node/{id}Obtains the node with the specified PowerGraph ID.format
application/json/node/{type}/{id}Obtains the node with the specified type and internal ID.format
application/json/nodebysig/{sig}Obtains the node with the specified WossiDiA signature.format
application/json/edges/{type}Obtains all edges of the specified type.edgeAttrs, edgeLinks, linkAttrs, nodeAttrs, nodeSigs, nodeNats, format
application/json/edges/{type}/{cond}Obtains edges of the specified type with the specified condition.
application/json/edge/{id}Obtains the edge with the specified ID.
application/json/graph/{pnid}/{path}Obtains a graph, starting from a single pivot node, expanding using a path expression.nodeAttrs, edgeAttrs, linkAttrs, graphStats, fullEdges
application/json/isebel/index/{expr}ISEBEL index access for story faceted search requests, returning IDs (and index data) for stories matching the search criteria and facets specified.word, place, person, gender, yearMin, yearMax, inclNoYear, data, limit
application/json/isebel/story/{id}ISEBEL record document access for story faceted search results, returning XML data for the story specified.
application/json/fieldnamesRecordDenotationSearchPerforms a full-text search on the fieldname attributes of all fn_record nodes and returns the IDs of the fn_denotation nodes, associated via egdetype fn_record_denotation and/or fn_record_denotation_preferred.expr, preferred, caseSensitive, minLength, limit
application/json/mwb/article/{dict}/{id}MWB article node access with WBN-specific enhancements, returning JSON data for the article specified.
application/json/authRequests an authentication token, which is used for PowerGraph update operations.role, pass
application/json/update/node/createCreates an empty node.auth, format, json
application/json/update/node/modifyUpdates a node's attribute value.auth, id, attr, value
application/json/update/node/deleteDeletes a node.auth, id
application/json/update/edge/createCreates an edge.auth, json
application/json/audio/uploadStory audio transcript upload.auth, storyId, langCode, audioData

Prints an overview of all API functions.

Returned document content type:
text/html

Returns the entire WossiDiA-PowerGraph catalog.

Request parameters:
  • Boolean types (optional, default: false)
    Include data types.
  • String sup (optional, default: id)
    Node/edge type expansion on the superior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String inf (optional, default: id)
    Node/edge type expansion on the inferior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String exp (optional, default: id)
    Role node types expansion.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • Boolean inheritedAttrs (optional, default: true)
    Include inherited attributes.
  • Boolean inheritedRoles (optional, default: true)
    Include inherited roles.
Returned document content type:
application/json

Returns all WossiDiA-PowerGraph datatypes.

Returned document content type:
application/json
/catalog/datatype/{dataType}

Returns a specific datatype.

Path variables:
  • String dataType (required)
    Data type name.
Returned document content type:
application/json

Returns all WossiDiA-PowerGraph node types.

Request parameters:
  • String sup (optional, default: id)
    Node type expansion on the superior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String inf (optional, default: id)
    Node type expansion on the inferior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • Boolean inheritedAttrs (optional, default: true)
    Include inherited node attributes.
Returned document content type:
application/json
/catalog/nodetype/{nodeType}

Returns the specified WossiDiA-PowerGraph node type.

Path variables:
  • String nodeType (required)
    Node type ID or name.
Request parameters:
  • String sup (optional, default: id)
    Node type expansion on the superior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String inf (optional, default: id)
    Node type expansion on the inferior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • Boolean inheritedAttrs (optional, default: true)
    Include inherited node attributes.
Returned document content type:
application/json

Returns all WossiDiA-PowerGraph edge types.

Request parameters:
  • String sup (optional, default: id)
    Edge type expansion on the superior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String inf (optional, default: id)
    Edge type expansion on the inferior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String exp (optional, default: id)
    Role node types expansion.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • Boolean inheritedAttrs (optional, default: true)
    Include inherited edge attributes.
  • Boolean inheritedRoles (optional, default: true)
    Include inherited roles.
Returned document content type:
application/json
/catalog/edgetype/{edgeType}

Returns the specified WossiDiA-PowerGraph edge type.

Path variables:
  • String edgeType (required)
    Edge type ID or name.
Request parameters:
  • String sup (optional, default: id)
    Edge type expansion on the superior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String inf (optional, default: id)
    Edge type expansion on the inferior axis.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • String exp (optional, default: id)
    Role node types expansion.
    IDInclude ID(s) and name(s) of referenced types only (default).
    FULLInclude full information for referenced types.
    TREEInclude full information for the whole tree of referenced types.
  • Boolean inheritedAttrs (optional, default: true)
    Include inherited edge attributes.
  • Boolean inheritedRoles (optional, default: true)
    Include inherited roles.
Returned document content type:
application/json
/nodes/{type}

Obtains all nodes of the specified type.

Path variables:
  • String type (required)
    Node type ID or name.
Returned document content type:
application/json
/nodes/{type}/{cond}

Obtains nodes of the specified type with the specified condition.

Path variables:
  • String type (required)
    Node type ID or name.
  • String cond (required)
    Selection condition for nodes, based on their attributes, IDs, and properties; for syntax see {@link Condition}.
Returned document content type:
application/json
/node/{id}

Obtains the node with the specified PowerGraph ID.

Path variables:
  • Integer id (required)
    Node ID.
Request parameters:
  • String format (optional, default: json)
    Node attribute output format: "json", "text".
Returned document content type:
application/json
/node/{type}/{id}

Obtains the node with the specified type and internal ID.

Path variables:
  • String type (required)
    Node type ID or name.
  • Integer id (required)
    Internal node ID.
Request parameters:
  • String format (optional, default: json)
    Node attribute output format: "json", "text".
Returned document content type:
application/json
/nodebysig/{sig}

Obtains the node with the specified WossiDiA signature.

Path variables:
  • String sig (required)
    Node signature.
Request parameters:
  • String format (optional, default: json)
    Node attribute output format: "json", "text".
Returned document content type:
application/json
/edges/{type}

Obtains all edges of the specified type.

Path variables:
  • String type (required)
    Edge type ID or name.
Request parameters:
  • Boolean edgeAttrs (optional, default: true)
    Include edge attributes.
  • Boolean edgeLinks (optional, default: true)
    Include edge links.
  • Boolean linkAttrs (optional, default: true)
    Include link attributes.
  • Boolean nodeAttrs (optional, default: false)
    Include linked nodes' attributes.
  • Boolean nodeSigs (optional, default: false)
    Include linked nodes' signatures.
  • Boolean nodeNats (optional, default: false)
    Include linked nodes' text representations.
  • String format (optional, default: json)
    Node attribute input format: "json", "text".
Returned document content type:
application/json
/edges/{type}/{cond}

Obtains edges of the specified type with the specified condition.

Path variables:
  • String type (required)
    Edge type ID or name.
  • String cond (required)
    Selection condition for edges, based on their attributes, IDs, and properties; for syntax see {@link Condition}.
Returned document content type:
application/json
/edge/{id}

Obtains the edge with the specified ID.

Path variables:
  • Integer id (required)
    Edge ID.
Returned document content type:
application/json
/graph/{pnid}/{path}

Obtains a graph, starting from a single pivot node, expanding using a path expression.

Path variables:
  • Integer pnid (required)
    Pivot node ID.
  • String path (required)
    Graph-building path expression.
Request parameters:
  • Boolean nodeAttrs (optional, default: true)
    Include node attributes.
  • Boolean edgeAttrs (optional, default: true)
    Include edge attributes.
  • Boolean linkAttrs (optional, default: true)
    Include link attributes.
  • Boolean graphStats (optional, default: false)
    Include graph statistics.
  • Boolean fullEdges (optional, default: true)
    Include all nodes in the edges, even those not affected by the edges.
Returned document content type:
application/json
/isebel/index/{expr}

ISEBEL index access for story faceted search requests, returning IDs (and index data) for stories matching the search criteria and facets specified.

Path variables:
  • String expr (required)
    Search expression, separated by space.
Request parameters:
  • String word (optional)
    Filter: Keywords, separated by space.
  • String place (optional)
    Filter: Place names, separated by space.
  • String person (optional)
    Filter: Person names, separated by space.
  • String gender (optional)
    Filter: Genders specified, 'm', 'f', any spaces.
  • Integer yearMin (optional)
    Filter: Earliest year.
  • Integer yearMax (optional)
    Filter: Latest year.
  • Boolean inclNoYear (optional, default: true)
    Filter: Include stories with no year specified (boolean).
  • Boolean data (optional, default: false)
    Return index data along with story IDs (boolean).
  • Integer limit (optional)
    Result set limit (1+).
Returned document content type:
application/json
/isebel/story/{id}

ISEBEL record document access for story faceted search results, returning XML data for the story specified.

Path variables:
  • Integer id (required)
    ID or type-internal ID of story (int).
Returned document content type:
application/json
/fieldnamesRecordDenotationSearch

Performs a full-text search on the fieldname attributes of all fn_record nodes and returns the IDs of the fn_denotation nodes, associated via egdetype fn_record_denotation and/or fn_record_denotation_preferred.

Request parameters:
  • String expr (required)
    Search terms.
  • Boolean preferred (optional, default: true)
    Search preferred denotations instead of general denotations.
  • Boolean caseSensitive (optional, default: false)
    Case sensitive search.
  • Integer minLength (optional, default: 2)
    Minimum length of individual search terms (1+).
  • Integer limit (optional, default: 10)
    Maximum search results count, 0 = unlimited.
Returned document content type:
application/json
/mwb/article/{dict}/{id}

MWB article node access with WBN-specific enhancements, returning JSON data for the article specified.

Path variables:
  • String dict (required)
    Use either "MeckWB" for volumes 1-7 or "MeckWBN" for volume 8.
  • String id (required)
    WBN ID.
Returned document content type:
application/json
/auth

Requests an authentication token, which is used for PowerGraph update operations.

Request parameters:
  • String role (required)
    Role ID to be authenticated.
  • String pass (required)
    Password for role.
Returned document content type:
application/json
Returned document description:
Authentication token for PowerGraph update operations, which is valid for 20 seconds after request or its most recent successful use.
/update/node/create

Creates an empty node.

Request parameters:
  • String auth (required)
    Authentication token.
  • String format (optional, default: json)
    Node attribute input format: "json", "text".
  • String json (required)
    JSON specification of node.

    Pattern:

    {
       "type": <type>,
       "attrs": {
          "<eid>": <val>,
          ...
       }
    }

    ...with:

    <type> ... Node type ID or name, e.g.: 11 or "am_person"
    <eid>  ... Node attribute composite ID, e.g.: 11.2
    <val>  ... JSON representation of node attribute value
    

Returned document content type:
application/json
/update/node/modify

Updates a node's attribute value.

Request parameters:
  • String auth (required)
    Authentication token.
  • Integer id (required)
    Node ID.
  • String attr (required)
    Attribute ID or name.
  • String value (required)
    Attribute value as JSON.
Returned document content type:
application/json
/update/node/delete

Deletes a node.

Request parameters:
  • String auth (required)
    Authentication token.
  • Integer id (required)
    Node ID.
Returned document content type:
application/json
/update/edge/create

Creates an edge.

Request parameters:
  • String auth (required)
    Authentication token.
  • String json (required)
    JSON specification of edge.

    Pattern:

    {
       "type": <type>,
       "attrs": {
          "<eid>": <val>,
          ...
       },
       "links": [
          {
             "role": <rid>,
             "node": <nid>,
             "attrs": {
                "<lid>": <val>,
                ...
             }
          },
          ...
       ],
    }

    ...with:

    <type> ... Edge type ID or name, e.g.: 1019 or "am_person"
    <eid>  ... Edge attribute composite ID, e.g.: 2.4
    <lid>  ... Link attribute composite ID, e.g.: 7.1.2
    <val>  ... JSON representation of attribute value
    <rid>  ... Composite role ID, e.g.: 1019.3
    <nid>  ... Linked node ID, e.g. 100001042
    

Returned document content type:
application/json
/audio/upload

Story audio transcript upload.

Request parameters:
  • String auth (required)
    Authentication token.
  • Integer storyId (required)
    Story ID.
  • String langCode (required)
    Audio language: 'deu', 'nds', 'eng', etc.
  • String audioData (required)
    Audio data (Base64).
Returned document content type:
application/json