{"componentChunkName":"component---src-templates-default-template-tsx","path":"/documentation/migration_topics/migration_6_7/","result":{"data":{"asciidoc":{"id":"a97e071f-2651-57dd-b6e3-5e9955699337","html":"
\n
\n
\n

Migrating from HIRO™ 6 to HIRO™ 7 provides you with new functionalities and a restructured API. The changes in the API’s required to move from HIRO™ 6 to 7 are available in this document.

\n
\n
\n
\n
\n

API Changes from HIRO™ 6 to 7

\n
\n
\n
    \n
  • \n

    There is now a common base url (https://core.engine.datagroup.de) for all customers and instances

    \n
    • \n
  • \n

    Each HIRO instance has its own scope which is used to manage access-permissions

    \n
    • \n
  • \n

    The ogit/_owner attribute no longer needs to be set when writing to provide visibility and access

    \n
    • \n
  • \n

    The structure of the path for calling the interfaces has been changed, swapping the position of the API version:
    \n/api/$VERSION/graph/ (previous)
    \n/api/graph/$VERSION/ (now)
    \nfor all available APIs, please visit https://core.engine.datagroup.de/help/

    \n
    • \n
  • \n

    The special treatment for ogit/Person (email address has also been used as the vertex id) has been removed.

    \n
    • \n
\n
\n
\n
\n
\n

Necessary adjustments in existing code

\n
\n
\n

To make your existing project work with HIRO™ 7 you will need to:

\n
\n
\n
\n
Update the Authentication API URL
\n
\n

New authentication URL: https://core.engine.datagroup.de/api/auth/6/app

\n
\n
Update the Graph API URL
\n
\n

New Graph-Api URL: https://core.engine.datagroup.de/api/graph/7/

\n
\n
Use scope instead of owner for permissions
\n
\n

Change your code to refer to your scope instead of an owner whenever you are performing a task:
\ne.g. when creating a new vertex set the attribute ogit/_scope
\ni.e ogit/_owner → ogit/_scope
\nFor details please read/follow the tutorial First Steps with HIRO

\n
\n
\n
\n
\n

Note - These API’s may be updated time to time. Latest API’s can be found at https://core.engine.datagroup.de/help/

\n
\n
\n
\n
\n

Action Handlers in HIRO 7

\n
\n
\n

In HIRO 6 Action Handlers were a part of the engine configuration and executed on the engine. Customers can now create their own on-premise action handlers using the Action API.

\n
\n
\n

For more information on the Action API, please visit Action API

\n
\n
\n
\n
URL to get capabilities and applicabilities
\n
\n

Capabilities: https://core.engine.datagroup.de/api/action/1/capabilities
\nApplicabilities: https://core.engine.datagroup.de/api/action/1/applicabilities

\n
\n
URL to create websocket
\n
\n

URL: wss://core.almato.ai/api/action-ws/1/
\nSubProtocol: action-1.0.0
\nSample websocket connection request:

\n
\n
\n
\n
\n
\n
const ws = new WebSocket('wss://core.almato.ai/api/action-ws/1/', ['action-1.0.0', 'token-' + '$token'])
\n
\n
\n
\n

Note - These API’s may be updated time to time. Latest API’s can be found at https://core.engine.datagroup.de/help/

\n
\n
\n
","document":{"main":"Migrating to HIRO™ 7 API","title":"Migrating to HIRO™ 7 API","subtitle":""},"fields":{"toc":false,"location":["documentation","migration_topics","migration_6_7"]}},"sidebarYaml":{"id":"6d066bdd-c982-5a69-b909-a31e6fc044e0","showIndex":null}},"pageContext":{"id":"a97e071f-2651-57dd-b6e3-5e9955699337","parent":"documentation"}},"staticQueryHashes":["1010459453","1010459453","2356112386","2356112386","2603905930","2603905930","3026652197","3026652197","3167850324","3167850324","63159454","63159454"]}