REST API
A catalog to access features and data available in the Platform
cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Forum Posts

Resolved! Basic Auth vs API Key (HOPEX V5 and forward)

Starting from HOPEX V5 the method for authentication for API has evolved. With a Basic Auth.With an API Key (preferred choice)   Former Bearer Token is not available in V5. Oauth2 Authentication is not supported for the moment for API calls.   Depend...

basicAuth.png oguimard_0-1678959250029.png oguimard_1-1678959271270.png oguimard_2-1678959520817.png

Resolved! Create custom schema (SDL/JSON) / custom endpoint

  The GraphQL REST API exposes in standard a subset of the full HOPEX Metamodel. This subset is organized into several endpoint represented by a schema (SDL). The split is mainly done by solution scope or technical grouping: ITPM, BPA, Audit…   It is...

jsonITPM.png metamodel.png folders.png cmd.png

Resolved! Filter data (where condition) in REST API with GraphQL

When building graphQL to query element, it is sometime interesting to filter the data by different criteria : filtering by name, by Id, by relationships... Filters represent a "where" condition in queries.   Filtering can  : filter by fields (MetaAtt...

filter_and_or.png name.png creationdate.png costperuser.png

REST API Documentation

HOPEX Platform come with REST API that can be used in a wide range of use cases.   The documentation of the endpoints of the HOPEX REST API is available as catalog as well as classical textual documentation.   Full Endpoint documentation   Click here...

GraphQL endpoints

The REST API heavily leverage the GraphQL framework. The GraphQL framework enable to have only one endpoint for all REST API call.   To ease navigation in the HOPEX platform repository we have created endpoint for each solution. The endpoint correspo...

GraphQL and Data Confidentiality (CRUD)

When making query or mutation to GraphQL REST API all access rights are check based on the profile you are using.   The access rights are defined, in this order, at several level : License levelOption levelProfile levelWorkflow levelData Reading or W...

Select the data language with the REST API

query user { personSystem(filter:{name:"Thomas"}) { id name dataLanguage { ...on Language { language:languageCode languageId:id languageName:name } } } } In HOPEX the data can be inputt...

language.png

Basic Auth vs. Bearer Token (HOPEX V3 or V4)

This post concern version V3 or V4. For V5 go to this link Basic Auth vs API Key (HOPEX V5 and forward)   The HOPEX REST API based on GraphQL allows to be called in two way : With a Basic AuthWith Bearer Token Depending on the use case you want to us...

basicAuth.png bearertoken.png

Pagination in REST API with GraphQL

When querying elements through the REST API a lot of items can be returned. To limit the size of items returned it can be relevant to paginate the data.   Pagination allows you to request a certain chunk of objects. You can seek forwards or backwards...

blank.png first.png firstandskip.png firstafter.png

Diagram API : Dowload a diagram by REST API

HOPEX contains diagrams that have been designed or generated. Within the web front end you can see and download the diagrams as images. The REST API also provide the ability to export the diagram as a file.   3 format of files are supported : PNG, JP...

Screen Shot 05-15-20 at 09.32 AM.PNG Screen Shot 05-15-20 at 09.34 AM.PNG Screen Shot 05-15-20 at 09.35 AM.PNG Screen Shot 05-15-20 at 09.38 AM.PNG

Attachment API : Upload or Download Business Document

In HOPEX, you can store attachments in the concept called Business Document. The files supported are numerous (DOCX, XLSX, JPEG, PNG, PDF,...) which can be uploaded/downloaded from the web interface. You may want to access this information by REST AP...

Screen Shot 04-15-20 at 12.17 PM 001.PNG Screen Shot 04-15-20 at 12.17 PM 002.PNG Screen Shot 04-15-20 at 12.34 PM.PNG Screen Shot 04-15-20 at 12.34 PM 001.PNG

Get GraphQL Schema as a file (SDL schema file)

When building graphQL query it can be convenient to use auto-completion to navigate the available information in the schema. Thus, useful to write the graphQL to read/write in the REST API.   For instance, for ITPM to know which MetaClass, MetaAttrib...

Screen Shot 04-14-20 at 04.02 PM.PNG Screen Shot 04-14-20 at 04.06 PM 001.PNG Screen Shot 04-14-20 at 04.06 PM 002.PNG Screen Shot 04-14-20 at 04.06 PM.PNG

Using Postman to call the REST API

Calling the REST API can be done with a wide range of tools. In this post we explain how to leverage postman to make HTTP request to the API.   The main steps to use postman with the HOPEX REST API are : Download postman Download postman collection t...

Asynchronous versus Synchronous Web service call

Each of the GraphQL endpoints, to query the repository, can return results in synchronous or asynchronous way.   To avoid confusion, it is important to make the difference between : What does the endpoint return ? Synchronous/Asynchronous responseHow...

Get a bearer token from UAS for REST API call

Before making any call to a REST API in HOPEX you need to get an authentication bearer token. This token will allow you to access the data based on your credentials. Prior to continue make sure you have at leat the there following information : the l...

bearer.png