Machine Registry

/apis/anagraphics

All the machines that make up a project are described through a series of textual information. To retrieve this information, you can use the following endpoint:

Request

HTTP
GET https://{BASE_URL}/apis/anagraphics

By making an HTTP GET request to the specified endpoint, you can retrieve information about all the machines belonging to the project.

Example

Request

HTTP
GET https://matdev.40mat.com/apis/anagraphics

Response

JSON
[
    {
        "customer": "40Factory",
        "customerId": "Line",
        "excludeLine": true,
        "id": "MCCabcabcabcabcabcabcabcabcabcabcabc",
        "location": {
            "latitude": "45.035863",
            "longitude": "9.759874"
        },
        "machineId": "40-line",
        "machineName": "CB231294",
        "machineReference": "M1",
        "machines": {
            "M1": {
                "components": [
                    "motor1",
                    "motor2"
                ]
            },
            "M2": {}
        },
        "model": "Wrapper Machine",
        "parentId": "subtentants/Line",
        "plant": "Piacenza",
        "settings": {
            "cons0Cost": 0.01,
            "cons0RelMean": 10.976927607602123,
            "cons0RelStd": 0.5301137150152502,
            "cons1Cost": 0.000131,
            "cons1RelMean": 1.0349332185509406,
            "cons1RelStd": 0.3433522379337663,
            "cons2Cost": 120,
            "cons2RelMean": 0.0015269034720833677,
            "cons2RelStd": 6.469884712715801e-05,
            "cons3Cost": 600,
            "cons3RelMean": 0.0001470083005766097,
            "cons3RelStd": 0.0022844333558226498,
            "nSigma": 1,
            "trainingEnd": "2024-03-08T23:00:00.000Z",
            "trainingStart": "2024-02-04T23:00:00.000Z"
        },
        "timezone": "Europe/Rome",
        "typeId": null
    },
    {
        "customer": "40Factory",
        "customerId": "Line",
        "excludeLine": true,
        "id": "MCCcdecdecdecdecdecdecdecdecdecdecdecdecde",
        "location": {
            "latitude": "45.035863",
            "longitude": "9.759874"
        },
        "machineId": "40-machine",
        "machineName": "CB231295",
        "machineReference": "M1",
        "machines": {
            "M1": {
                "components": [
                    "motor1",
                    "motor2"
                ]
            },
            "M2": {}
        },
        "model": "Pallettizer Machine",
        "parentId": "subtentants/Line",
        "plant": "Piacenza",
        "settings": {
            "cons0Cost": 0.01,
            "cons0RelMean": 10.976927607602123,
            "cons0RelStd": 0.5301137150152502,
            "cons1Cost": 0.000131,
            "cons1RelMean": 1.0349332185509406,
            "cons1RelStd": 0.3433522379337663,
            "cons2Cost": 120,
            "cons2RelMean": 0.0015269034720833677,
            "cons2RelStd": 6.469884712715801e-05,
            "cons3Cost": 600,
            "cons3RelMean": 0.0001470083005766097,
            "cons3RelStd": 0.0022844333558226498,
            "nSigma": 1,
            "trainingEnd": "2024-03-08T23:00:00.000Z",
            "trainingStart": "2024-02-04T23:00:00.000Z"
        },
        "timezone": "Europe/Rome",
        "typeId": null
    }
]

Code

Python

import requests
import json

# Example data for the header
headers = {
    'App-Name': 'matdev-be',
    'Authorization': 'Bearer ey....xy1w'
}

# URL of the third-party API
myDomain = 'matdev.40mat.com'
endpoint = '/apis/anagraphics'
url = f'https://{myDomain}{endpoint}'


# Make the POST request
response = requests.get(url, headers=headers, )

# Check the response status and return the data
if response.status_code == 200:
    print('Success:')
    print(json.dumps(response.json(), indent=4))
else:
    print('Request failed:')
    print(f'Status code: {response.status_code}')
    print(response.text)

OpenAPI

get

This endpoint returns information about all the assets of the current project.

Authorizations

bearerAuthbasicAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

Responsearray

list of objects where each object describes different properties of a machine

400

Bad Request.

401

Unauthorized.

403

Forbidden.

404

Not Found.

500

Internal Server Error.

503

Service Unavailable.

504

Gateway Timeout.

get

/apis/anagraphics

HTTPcURLJavaScriptPython

GET /apis/anagraphics HTTP/1.1
Host: localhost:3001
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[]

/apis/anagraphics/<assetId>

To retrieve the information that describes a specific machine in a project, you can use the following endpoint:

Request

HTTP
GET https://{BASE_URL}/apis/anagraphics/<assetId>

assetId : represents the unique ID of the machine you are interested in.

Example

Request

HTTP
GET https://matdev.40mat.com/apis/anagraphics/40-line

Response

JSON
[
    {
        "customer": "40Factory",
        "customerId": "Line",
        "excludeLine": true,
        "id": "MCCabcabcabcabcabcabcabcabcabcabcabc",
        "location": {
            "latitude": "45.035863",
            "longitude": "9.759874"
        },
        "machineId": "40-line",
        "machineName": "CB231294",
        "machineReference": "M1",
        "machines": {
            "M1": {
                "components": [
                    "motor1",
                    "motor2"
                ]
            },
            "M2": {}
        },
        "model": "Wrapper Machine",
        "parentId": "subtentants/Line",
        "plant": "Piacenza",
        "settings": {
            "cons0Cost": 0.01,
            "cons0RelMean": 10.976927607602123,
            "cons0RelStd": 0.5301137150152502,
            "cons1Cost": 0.000131,
            "cons1RelMean": 1.0349332185509406,
            "cons1RelStd": 0.3433522379337663,
            "cons2Cost": 120,
            "cons2RelMean": 0.0015269034720833677,
            "cons2RelStd": 6.469884712715801e-05,
            "cons3Cost": 600,
            "cons3RelMean": 0.0001470083005766097,
            "cons3RelStd": 0.0022844333558226498,
            "nSigma": 1,
            "trainingEnd": "2024-03-08T23:00:00.000Z",
            "trainingStart": "2024-02-04T23:00:00.000Z"
        },
        "timezone": "Europe/Rome",
        "typeId": null
    }
]

Code

Python

import requests
import json

# Example data for the header
headers = {
    'App-Name': 'matdev-be',
    'Authorization': 'Bearer ey....xy1w'
}

# URL of the third-party API
myDomain = 'matdev.40mat.com'
myAssetId = '40-line'
endpoint = f'/apis/anagraphics/{myAssetId}'
url = f'https://{myDomain}{endpoint}'


# Make the POST request
response = requests.get(url, headers=headers, )

# Check the response status and return the data
if response.status_code == 200:
    print('Success:')
    print(json.dumps(response.json(), indent=4))
else:
    print('Request failed:')
    print(f'Status code: {response.status_code}')
    print(response.text)

OpenAPI

get

This endpoint returns information about the specified asset. Information for all assets is returned if no assetId parameter is specified.

Authorizations

bearerAuthbasicAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

assetIdstringRequired

Responses

200

OK

application/json

Responseobject

object where each couple key - value describes a different property of a machine

400

Bad Request.

401

Unauthorized.

403

Forbidden.

404

Not Found.

500

Internal Server Error.

503

Service Unavailable.

504

Gateway Timeout.

get

/apis/anagraphics/{assetId}

HTTPcURLJavaScriptPython

GET /apis/anagraphics/{assetId} HTTP/1.1
Host: localhost:3001
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{}