Method, arrangement and personnel conveyor and / or access control system for interface requests
Through a unified application programming interface, the integration complexity problem between different manufacturers' systems is solved, unified control and information acquisition across systems is achieved, and the integration process is simplified and efficiency is improved.
Patent Information
- Application Number
- CN202510084487.4
- Authority / Receiving Office
- CN · China
- Patent Type
- Applications(China)
- Current Assignee / Owner
- Priority Date
- 2024-01-23
- Filing Date
- 2025-01-20
- Publication Date
- 2025-07-25
AI Technical Summary
The existing elevator and escalator APIs are designed to be manufacturer-specific equipment, resulting in complex, time-consuming and expensive integration, and the communication protocols between different manufacturers are unknown, limiting operational benefits.
Receive requests through the application programming interface of the primary personnel conveyor and/or access control system, identify the target system and convert or modify the request format to adapt to the APIs of different providers, and achieve unified interface processing across manufacturers.
Simplifies the integration process, improves integration speed and reliability, supports unified control and information acquisition of multi-manufacturer systems, and is suitable for rapid integration of robot companies.
Smart Images

Figure CN120364539A_ABST
Abstract
Description
Technical Field
[0001] The present invention generally relates to the technical fields of people conveyors and access control technologies. In particular, the present invention relates to arrangements, people conveyors, and / or access control systems and methods for processing application programming interface (API) requests. Background Art
[0002] Generally, elevators and escalators are controlled by a combination of hardware and software systems to ensure safe and efficient operation. For example, an elevator control system manages various aspects of elevator functions, such as floor selection, door operation, and safety features.
[0003] In addition, access control systems are also known. An access control system can include one or more access gates, which can be, for example, physical barriers or checkpoints that control entry into or exit from a specific area, facility, or property. The access gate can be, for example, a turnstile, a sliding door, or a swing door, which allows one person to pass through at a time.
[0004] Recently, solutions have emerged that enable external systems to interact with people conveyor systems and / or access control systems. For example, some elevator and escalator manufacturers have developed API-based functionality for elevators and escalators. An application programming interface (API) is a set of rules and protocols that allows different software applications to communicate with each other. The API defines the methods and data formats that an application or device can use to send requests and exchange information.
[0005] The application programming interface (API) related to elevators and escalators allows developers to control the elevator system, interact with the elevator system, or collect data from it. These types of APIs can enable the integration of elevator control into building management systems, smart applications, and automation solutions. Current elevator and escalator APIs are designed to control only the equipment of a specific manufacturer, so users of these APIs must implement multiple different solutions in order to operate with elevator and escalator systems from multiple manufacturers or even multiple generations or types of products from the same manufacturer. This makes integration complex, time-consuming, and expensive because users of the API must develop, maintain, and test multiple systems to work with different manufacturers' APIs. Currently, for example, robotics companies need to implement their own technology integrations for each piece of equipment (such as elevators and escalators).
[0006] In addition, all major elevator and escalator manufacturers also provide maintenance services for equipment manufactured by other manufacturers. Manufacturers can easily control and receive data from their own equipment, but they have the same challenges with competing equipment due to unknown communication protocols, etc. In the case of providing services to competing equipment, this limits the operational benefits.
[0007] Therefore, additional solutions need to be developed to mitigate the described drawbacks. SUMMARY OF THE INVENTION
[0008] An object of the present invention is to provide a method, arrangement, and personnel conveyor and / or access control system for processing application programming interface (API) requests.
[0009] The object of the present invention is achieved by a method, arrangement, and personnel conveyor and / or access control system as defined by the respective independent claims.
[0010] According to a first aspect, the present invention relates to a method for processing personnel conveyor and / or access control system application programming interface (API) requests. The method includes receiving a request through a main personnel conveyor and / or access control system application programming interface (API), determining the target system of the request, and based on the identified target system of the request being a first provider's personnel conveyor and / or access control system, sending the request to the application programming interface (API) of the first provider's personnel conveyor and / or access control system, for example without processing, and based on the identified target system of the request being a second or additional provider's personnel conveyor and / or access control system, processing the request and sending the processed request to the application programming interface (API) of the second or additional provider's personnel conveyor and / or access control system and / or the control interface of the second or additional provider's personnel conveyor and / or access control system.
[0011] In an embodiment of the present invention, the processing of the request includes converting and / or modifying the request to suit the application programming interface (API) of the first, second, and / or additional provider's personnel conveyor and / or access control system, for example such that the request corresponds to the rules or format of the application programming interface (API) of the first, second, and / or additional provider's personnel conveyor and / or access control system.
[0012] In an embodiment of the present invention, the main personnel conveyor and / or access control system application programming interface is connected or communicates with at least one internal application programming interface (API), such as the application programming interface (API) of the first provider's personnel conveyor and / or access control system, and / or is connected or communicates with at least one external application programming interface (API), such as the application programming interface (API) of the second or additional provider's personnel conveyor and / or access control system.
[0013] In an embodiment of the present invention, the method further includes receiving a response from the application programming interface to which the request is sent, and submitting the response or information related to the response to the device or entity from which the request was received.
[0014] In an embodiment of the present invention, the method further includes processing the received response and sending the processed response to the device or entity from which the request was received.
[0015] In one embodiment of the present invention, the processing of the response includes converting and / or modifying the response according to the main personnel conveyor and / or access control system application programming interface, for example, such that the request corresponds to the rules or formats of the main personnel conveyor and / or access control system application programming interface (API).
[0016] In one embodiment of the present invention, the processing of the request and / or response is performed using a processor device such as a technology integrator adapter or interface.
[0017] In one embodiment of the present invention, the application programming interface (API) request is related to at least one of the following: an elevator call, a service robot using an elevator, an escalator, and / or an access control system, the status of an elevator, an escalator, and / or access control equipment and / or devices, and / or the status of an elevator, an escalator, and / or access control services.
[0018] In one embodiment of the present invention, the main personnel conveyor and / or access control system application programming interface (API) includes or is connected to an access control, and the access control includes means for integrating an external system into the personnel conveyor and / or access control system via the main personnel conveyor and / or access control application programming interface (API), such as a first provider personnel conveyor and / or access control system and / or a second provider personnel conveyor and / or access control system.
[0019] In one embodiment of the present invention, the first provider personnel conveyor and / or access control system, the second provider personnel conveyor and / or access control system, and / or other provider personnel conveyor and / or access control systems are elevators, escalators, and / or access control systems, including elevators and control means for elevators, escalators and control means for escalators, and / or access controls and control means for access controls.
[0020] According to a second aspect, the present invention relates to an arrangement for processing requests for a personnel conveyor and / or access control system application programming interface (API), such as a server or service. The arrangement is configured to receive a request via the main personnel conveyor and / or access control system application programming interface (API), determine the target system of the request, and based on the identified target system of the request being a first provider personnel conveyor and / or access control system, send the request to the application programming interface (API) of the first provider personnel conveyor and / or access control system without processing, and based on the identified target system of the request being a second or additional provider personnel conveyor and / or access control system, process the request and send the processed request to the application programming interface (API) of the second or additional provider personnel conveyor and / or access control system and / or the control interface of the second or additional provider personnel conveyor and / or access control system.
[0021] In one embodiment of the present invention, the arrangement is configured to perform a method according to any embodiment of the present invention.
[0022] According to a third aspect, the present invention relates to a people conveyance system, such as an elevator system or an escalator system, and / or an access control system, comprising an arrangement for processing people conveyance system and / or access control system application programming interface (API) requests, such as a server or a service, wherein the arrangement is an arrangement according to any embodiment of the present invention.
[0023] According to a fourth aspect, the present invention relates to a computer program comprising instructions which, when executed by a computer (such as a server or a device), cause the computer to perform a method according to any embodiment of the present invention.
[0024] According to a fifth aspect, the present invention relates to a computer-readable medium comprising a computer program according to any embodiment of the present invention.
[0025] One advantage of the method, device and people conveyor system according to the present invention is that with the solution of the present invention, a user (such as a system integrator or a developer) only needs to use one application programming interface (API), which can then further use other APIs based on the system involved in the API query. Such a solution makes all types of integration work faster and more reliable. For example, when a developer does not need to consider which type of people conveyance system needs to be integrated into other building systems. The solution of the present invention also helps a people conveyor service entity to control and obtain information from systems manufactured by manufacturers different from the service entity, because a single API can be used to control and receive information from people conveyor systems and / or access controls of different manufacturers. The solution of the present invention also helps robot companies to integrate faster, because they can use a single control API regardless of which conveyor or access control device their robots use.
[0026] The exemplary embodiments of the present invention presented in this patent application should not be construed as limiting the applicability of the appended claims. The verb "comprising" is used in this patent application as an open limitation, which does not exclude the existence of also unrecited features. Unless otherwise explicitly stated, the features recited in the dependent claims can be freely combined with each other.
[0027] The expression "a plurality of" can herein refer to any positive integer starting from one. The expression "a plurality of" can separately refer to any positive integer starting from two.
[0028] The novel features considered to be characteristics of the present invention are particularly set forth in the appended claims. However, the invention itself, as well as its construction and method of operation, and its additional objects and advantages, will best be understood from the following description of specific embodiments when read in conjunction with the accompanying drawings. BRIEF DESCRIPTION OF THE DRAWINGS
[0029] In the drawings of the present invention, embodiments of the present invention are shown by way of example and not limitation.
[0030] Figure 1 Solutions according to example embodiments of the present invention are schematically shown.
[0031] Figure 2 Example embodiments of elevators that can be used with the solutions of the present invention are shown.
[0032] Figure 3 Example embodiments of escalators that can be used with the solutions of the present invention are shown.
[0033] Figure 4 An example method according to an example embodiment of the present invention is shown. DETAILED DESCRIPTION
[0034] In the solution of the present invention, requests for conveyors and access control systems for different people can be processed via an application programming interface (API). In this application, such an application programming interface (API) is referred to in this patent application as the main system API or the main personnel conveyor and / or access control system API, and requests for different personnel conveyors and / or access control systems can be processed through this API. The functions of this application programming interface (API) can be implemented, for example, at a server or service (such as a cloud service). Developers can access and / or control the application programming interface (API) via a cloud environment and / or, for example, via a portal.
[0035] The application programming interface (API) used in the solution of the present invention is a software interface that allows developers to interact with and control elevators, escalators, and / or access control systems and / or collect data from them programmatically. These APIs integrate elevators, escalators, and access control into building management systems, smart applications, and automation solutions. The availability and functions of the API can vary depending on the manufacturer and the specific system being used.
[0036] In one embodiment of the present invention, the main personnel conveyor and / or access control system application programming interface (API) includes or is connected to an access control, and the access control includes means for integrating an external system into the personnel conveyor and / or access control system via the main personnel conveyor and / or access control application programming interface (API), such as a first provider personnel conveyor and / or access control system and / or a second provider personnel conveyor and / or access control system.
[0037] In one embodiment of the present invention, the first provider personnel conveyor and / or access control system, the second provider personnel conveyor and / or access control system, and / or other provider personnel conveyors and / or access control systems are elevators, escalators, and / or access control systems, including elevators and control devices for elevators, escalators and control devices for escalators, and / or access control and control devices for access control.
[0038] In one embodiment of the present invention, the main personnel conveyor and / or access control system application programming interface is connected or communicates with at least one internal application programming interface (API), such as the application programming interface (API) of the first provider personnel conveyor and / or access control system, and / or is connected or communicates with at least one external application programming interface (API), such as the application programming interface (API) of the second, third, or other provider personnel conveyors and / or access control systems.
[0039] In the solution of the present invention, an API request, for example, from a device or system, is received through the main personnel conveyor and / or access control system application programming interface (API). Based on the request, the target system of the request is determined. If the target of the API request is the first provider personnel conveyor and / or access control system, the request is sent to the application programming interface (API) of the first provider personnel conveyor and / or access control system, with or without processing. If the identified target system of the request is the second, third, or other provider personnel conveyors and / or access control systems, the request can be processed. Then, based on the target system, the processed request is sent to the application programming interface (API) of the second, third, or other provider personnel conveyors and / or access control systems and / or the control interface of the second, third, or other provider personnel conveyors and / or access control systems.
[0040] The request can be processed such that the request conforms to the rules or format of the application programming interface (API) of the target system. The processing can, for example, include converting and / or modifying the request to suit the application programming interface (API) of the target system API and having the format of that API. In one embodiment of the present invention, the processing of the request and / or response is performed using a processor device such as a technology integrator adapter or interface.
[0041] An API that has received a request sent by a slave device or system via the main system API can send a response to the request it has received. The response from the application programming interface to which the request was sent can be received by the main system API, and the main system API can submit the response or information related to the response to the device or entity from which it received the original request. The received response can be further processed and / or sent to the device or entity from which the original request was received. The API can return data in a standardized format, such as JSON (JavaScript Object Notation) or XML (Extensible Markup Language), for example.
[0042] In one embodiment of the present invention, the processing of the response includes converting and / or modifying the response according to the main personnel conveyor and / or access control system application programming interface, for example, such that the request corresponds to the rules or format of the main personnel conveyor and / or access control system application programming interface (API).
[0043] Figure 1 A solution according to an exemplary embodiment of the present invention is schematically shown. In Figure 1 the example, the main system API (such as the main personnel conveyor and / or access control system API) receives API calls or requests from different devices or systems (such as a robotic system, a mobile device, or other systems). The main system API can be connected to a backend, such as a server or service, which is capable of processing the received API requests and can process them and / or forward them to be processed into the correct format, for example, via an API technology interface. The API technology interface can be integrated into the backend, such as a server or service, or it can be an external module or unit.
[0044] The request (with or without processing) can be transmitted to the correct system API. In Figure 1 the example, two internal systems are connected to the main system API: the first system HW1 API and the first system HW2 API. In Figure 1 the example, two external systems are connected to the main system API: the second system API and the third system API. In a similar manner, other systems can be integrated and / or connected to the main system API. With the solution of the present invention, the corresponding systems (the first system HW1, the first system HW2, the second system, and the third or additional systems) can be reached via their APIs. Developers do not have to consider the differences between these APIs (such as the first system HW1 API, the first system HW2 API, the second system API, and the third (or additional) system API), but can communicate with different systems via one API (such as the main system API).
[0045] The first systems HW1 and HW2 can be systems where, for example, the hardware is different (e.g., different generations), and thus their APIs can be different from each other. The first systems HW1 and HW2 can still be from the same manufacturer, and thus in some embodiments, using an API technology interface is optional, e.g., because the same API format and commands can already be implemented and supported with the main system API.
[0046] Figure 2 An example elevator in which the solution of the present invention can be used is schematically shown. The elevator 200 according to an example embodiment can include an elevator car 210, which is arranged to move in an elevator shaft 212. The movement of the elevator car 210 can be achieved by a hoisting rope or belt 213 connected to a traction sheave 214 or the like. In addition, the elevator 200 includes an elevator motor, which is arranged to operate (such as by rotating its rotor) the traction sheave 214 to move the elevator car 210 if the traction sheave 214 is not substantially directly coupled to the hoisting rope 213. The traction sheave 214 can be directly or indirectly connected to the shaft of the motor via a mechanical connection. The elevator 200 can include a machine room or be machine-roomless, e.g., having the motor in the elevator shaft 212.
[0047] The elevator 200 can include at least one or at least two traction machine brakes 216, which are configured to directly or via the traction sheave 214 or its components and / or between them resist or preferably prevent the movement of the motor (i.e., its rotor). In addition, the elevator 200 can include a brake controller 225, which is configured to operate at least one of the at least one traction machine brakes 216. The brake controller 225 can also be connected to other elements of the elevator 200, such as an elevator control unit and / or a safety system. The brake controller 225 can include an actuator (not shown) for operating the brakes 216 or be at least connected to such an actuating device.
[0048] In addition, at least in some embodiments, a counterweight 218 can be arranged to be connected to the elevator car 210, as is known to a person skilled in the art of elevators. Further, the elevator 200 can additionally include one or more guide rails 217 arranged in the elevator shaft 212 for guiding the movement of the elevator car 210.
[0049] Figure 2The elevator 200 may also include a converter unit. The converter unit may include or essentially be an inverter or frequency converter for connecting to and controlling the operation of the motor, and a controller connected to the converter unit, where the controller is configured to operate the converter unit to supply electrical power (signal) having variable voltage and variable frequency, for example, to the windings of the motor. For example, the controller may be a separate controller device or be included in the converter unit.
[0050] Furthermore, the converter unit may be arranged to be powered by a power source such as the elevator 200, for example, from an external power grid or main power supply or another power source (such as a battery system). Additionally, the power source may draw electrical power from the converter unit.
[0051] One or more devices may be present between the power source and the converter unit, such as an input filter, circuit breaker, and / or contactor or relay, and / or a device for charging the energy storage element of the converter unit.
[0052] The elevator 200 preferably includes a landing 219 or landing floor 219 and, for example, landing floor doors and / or openings, and the elevator car 210 is arranged to move between the landing 219 or landing floor 219 and, for example, the landing floor doors and / or openings during normal operation of the elevator 200 in order to move people and / or goods between the said floors 219.
[0053] The elevator may include at least one control unit 220 for controlling the operation of the elevator and / or the safety system of the elevator. The control unit 220 may be a separate device or may be included in other components of the elevator, for example, in an electric drive or as part of an electric drive. The control unit may also be implemented in a distributed manner such that, for example, a part of the conveyor control unit may be included in the electric drive while another part is included in the elevator car. The control unit may also be arranged in a distributed manner at more than two locations or in more than two devices. In one embodiment of the present invention, the control unit is configured to control the power unit supplying power to the conveyor system. The elevator control unit may also be configured to collect status information of the elevator car and fault information when a fault occurs in the elevator.
[0054] The movement of the elevator car may be controlled at least in part by the elevator control unit. When the elevator car is configured to reach a desired landing, the speed of the elevator car is indicated to decelerate so that the elevator car can stop at the landing. Deceleration is the operation of reducing the speed of the elevator car from the normal operating speed to a lower speed and / or stopping. Deceleration may also be referred to as speed reduction.
[0055] The elevator system may include an application programming interface (API), and the elevator system API may be accessed via the main system API of the solution of the present invention. In Figure 1In an example, one or more systems (e.g., first system HW1, first system HW2, second system, and / or third system) may be in accordance with Figure 2 an elevator system.
[0056] Figure 3 FIG. schematically shows an embodiment of an escalator that can be used with the solution of the present invention. The escalator 300 may include a step chain that is coupled to a motor 306 via a transmission 302, and the transmission 302 includes at least one chain or belt or the like. The motor 306 can generate a rotational force via the transmission such that the step chain moves in the intended direction of travel. A brake can be arranged in the conveyor system such that when power is cut off, it is set to meet the rotational shaft of the transmission, and in this way, when the escalator system is idle, the movement of the step chain is braked or the step chain is kept stationary. When power is applied, the brake opens, allowing the step chain to move. In the context of an escalator system, the transmission may include a gearbox having the mentioned entities. In addition, the escalator system may include an escalator control unit 310, and the escalator control unit 310 may be configured, for example, to control the movement of the step chain by controlling the power supply to the motor 302 and the escalator brake. In one embodiment of the present invention, the conveyor system may include a processing unit 304. In some embodiments, a second motor 307 having a second transmission 303 may be provided, for example, at the opposite end of the step chain. Then, a second processing unit 305 may be installed to be connected to the second motor.
[0057] The escalator system may include an application programming interface (API), and the escalator system API may be accessed via the main system API of the solution of the present invention. In Figure 1 an example, one or more systems (e.g., first system HW1, first system HW2, second system, and / or third system) may be in accordance with Figure 3 an escalator system.
[0058] The solution of the present invention can also be used with access control. As mentioned before, access control can be, for example, a physical barrier or checkpoint that controls entry into or exit from a specific area, facility, or property. Access control can be found in many environments and buildings, such as residential communities, commercial buildings, industrial sites, and public facilities. Access control can be, for example, a turnstile, a sliding door, or a swinging door that allows one person to pass through at a time. Access control can also be connected to or integrated with an access control system. These systems can use key cards, key fobs, biometric devices, or other authentication methods to grant or deny access.
[0059] The access control system may include an application programming interface (API), and the access control system API may be accessed via the main system API of the solution of the present invention. InFigure 1 In an example, one system or multiple systems (e.g., the first system HW1, the first system HW2, the second system, and / or the third system) can access a door system according to the above embodiments.
[0060] In an embodiment of the present invention, an application programming interface (API) request is related to at least one of the following: an elevator call, a service robot using an elevator, an escalator, and / or an access control system, the status of an elevator, an escalator, and / or access control equipment and / or devices, and / or the service status of an elevator, an escalator, and / or an access control system.
[0061] The application programming interface (API) can be, for example, an elevator call API (using which requests related to elevator calls can be issued), an access API, a service robot API, an API related to the technical status of the system, such as an equipment status API, a service information API, a real-time monitoring API, an alarm and fault API, an energy-related API, a people flow API, or a sensing API (e.g., for detecting people or users in communication), and / or a field API (e.g., a field elevator call API, a field robot API, a field real-time monitoring API).
[0062] In an embodiment of the present invention, the API may require authentication to ensure that only authorized users or applications can access its resources. The authentication method may include at least one of the following: an API key, OAuth, JWT (JSON Web Token). The API may be vulnerable to various threats, such as injection attacks, unauthorized access, and data leakage. In an embodiment of the present invention, at least one API can be used to implement appropriate security measures, such as encryption and / or input validation.
[0063] The following are some other examples of the API and its functions, which can be used at least in some embodiments of the solution of the present invention:
[0064] • Elevator control APIs: These APIs can provide access to elevator control functions, allowing developers to send commands to the elevator system to, for example, move the elevator car, open and close doors, and perform other control actions. They can be used for building automation and integration with smart building systems.
[0065] • Monitoring and data APIs: Elevators, escalators, and / or access control systems can generate a large amount of data, including, for example, status information, operation statistics, and / or error logs. The monitoring and data APIs can allow developers and other systems to retrieve real-time and / or historical data from elevators, escalators, and / or access control systems, which can be used for, for example, maintenance, performance analysis, and / or reporting.
[0066] • Remote Management API: Elevators, escalators, and / or access control systems can provide a remote management API that enables administrators to monitor and manage system operations from a centralized location. These APIs can be used to perform tasks such as updating firmware, diagnosing problems, and changing system settings.
[0067] • Access Control API: Elevators, escalators, and / or access control systems can be integrated with access control systems to control access based on user permissions. The access control API can allow developers and system administrators to manage access rights, configure access policies, and integrate elevators, escalators, and / or access control with card access or biometric systems.
[0068] • Diagnostic and Maintenance API: Elevators, escalators, and / or access control systems can use a diagnostic and maintenance API to remotely access elevator, escalator, and / or access control system health data, perform diagnostics, and schedule preventive maintenance based on real-time performance metrics.
[0069] • User Interface API: These APIs can enable the development of user interfaces for passengers or building operators to interact with elevators, escalators, and / or access control systems. This can include touchscreen control panels, mobile apps, and digital signage displays.
[0070] The APIs used in the solution of the present invention can be implemented, for example, as web APIs. The APIs can be exposed over the Internet using standard web protocols such as HTTP. Examples include RESTful APIs, SOAP APIs, and GraphQL APIs. Web APIs typically use HTTP verbs (GET, POST, PUT, DELETE, etc.) to define the type of operation to be performed on a resource. For example, a GET request is used to retrieve data, while a POST request is used to create or update data.
[0071] In the following, some example API requests are presented. These are only examples and are used to illustrate the concepts that can be implemented with the solution of the present invention.
[0072] Examples of main system API and target system API calls:
[0073] • Example 1 API call to get the elevator status
[0074] API call:
[0075] ```http
[0076] GET / api / v1 / conveyors / {conveyor_id} / status
[0077] ```
[0078] This example API call retrieves the status of a specific people conveyor (elevator, escalator, or access gate). The `{conveyor_id}` in the URL should be replaced with the ID of the conveyor.
[0079] Response:
[0080] ```json
[0081] {
[0082] "conveyor_id": "123",
[0083] "status": "operational",
[0084] "last_maintenance": "2024-01-21T14:30:00Z"
[0085] }
[0086] ```
[0087] This main system API call can be transformed into a target system API call specific to the target system (e.g., the manufacturer of the conveyor). For example, if the conveyor is a lift from "First Manufacturer", the main system API call can be transformed into a "First Manufacturer" specific API call such as `GET / API / v1 / first-manufacturer / elevators / {elevator_id} / status`.
[0088] • Example 2 API call for controlling an access gate
[0089] API call:
[0090] ```http
[0091] POST / api / v1 / gates / {gate_id} / control
[0092] ```
[0093] This API call sends a control command to a specific access gate. The `{gate_id}` in the URL should be replaced with the ID of the gate.
[0094] Request body:
[0095] ```json
[0096] {
[0097] "command": "open_gate"
[0098] }
[0099] ```
[0100] Response:
[0101] ```json
[0102] {
[0103] "status": "success",
[0104] "message": "Command received and is being processed."
[0105] }
[0106] ```
[0107] The main system API call can be converted into a target system API call specific to the target system (e.g., the manufacturer of the access control). For example, if the access control is from the "Second Manufacturer", the main system API call can be converted into a "Second Manufacturer"-specific API call such as `POST / API / v1 / second - manufacturer / gates / {gate_id} / commands`.
[0108] Examples of main system API calls (which can be converted into target system API calls if needed):
[0109] • Example 1 API call to get the elevator status
[0110] API call:
[0111] ```http
[0112] GET / api / v1 / elevators / {elevator_id} / status
[0113] ```
[0114] This API call retrieves the status of a specific elevator. The `{elevator_id}` in the URL should be replaced with the ID of the elevator.
[0115] Response:
[0116] ```json
[0117] {
[0118] "elevator_id": "123",
[0119] "status": "operational",
[0120] "last_maintenance": "2024-01-21T14:30:00Z"
[0121] }
[0122] ```
[0123] • Example 2: API Call to Send Commands to an Elevator
[0124] API Call:
[0125] ```http
[0126] POST / api / v1 / elevators / {elevator_id} / commands
[0127] ```
[0128] This API call sends commands to a specific elevator. The `{elevator_id}` in the URL should be replaced with the ID of the elevator.
[0129] Request Body:
[0130] ```json
[0131] {
[0132] "command": "move_to_floor",
[0133] "floor_number": 5
[0134] }
[0135] ```
[0136] Response:
[0137] ```json
[0138] {
[0139] “status”: “success”,
[0140] "message": "Command received and is being processed."
[0141] }
[0142] ```
[0143] • Example 3: API Call to Get Elevator Maintenance History
[0144] API Call:
[0145] ```http
[0146] GET / api / v1 / elevators / {Elevators_ID} / maintenance_history
[0147] ```
[0148] This API call retrieves the maintenance history of a specific elevator. The `{Elevator_ID}` in the URL should be replaced with the ID of the elevator.
[0149] Response:
[0150] ```json
[0151] {
[0152] "elevator_id": "123",
[0153] "maintenance_history":
[0154] {
[0155] "date": "2024-01-21T14:30:00Z",
[0156] "maintenance_type": "annual",
[0157] "technician": "John Doe"
[0158] },
[0159] {
[0160] "date": "2023-12-20T10:15:00Z",
[0161] "maintenance_type": "repair",
[0162] "technician": "Jane Smith"
[0163] }
[0165] }
[0166] ```
[0167] Figure 4 An example method according to an example embodiment of the present invention is shown. The example method includes receiving a request via a primary personnel conveyor and / or an access control system application programming interface (API), determining a target system of the request, and based on the identified target system of the request being a first provider personnel conveyor and / or an access control system, sending the request to the application programming interface (API) of the first provider personnel conveyor and / or an access control system, for example without processing, and based on the identified target system of the request being a second or additional provider personnel conveyor and / or an access control system, processing the request and sending the processed request to the application programming interface (API) of the second or additional provider personnel conveyor and / or an access control system and / or a control interface of the second or additional provider personnel conveyor and / or an access control system.
[0168] The server, elevator unit, escalator unit, access control unit, and / or control unit or controller of the system (e.g., an elevator, escalator, and / or access control unit) may include one or more processors, one or more volatile or non-volatile memories for storing portions of computer program code and any data values, and possibly one or more user interface units. The elements mentioned may be communicatively coupled to each other via, for example, an internal bus. One or more processors of the processing unit may be any suitable processor for processing information and controlling the operation of the unit as well as other tasks. The memory unit may store portions of computer program code and any other data, and the processing unit may cause the unit to operate as described above by executing at least some portions of the computer program code stored in the memory unit. In addition, one or more memories of the memory unit may be volatile or non-volatile. Furthermore, one or more memories are not limited to a certain type of memory, but rather any memory type suitable for storing the described pieces of information may be applied in the context of the present invention. The communication unit may be based on at least one known communication technology, wired or wireless, in order to exchange information segments as described above. The communication unit may provide an interface for communicating with any external unit, such as a brake control unit of a drive unit, a positioning system, a database, and / or any external system. The unit may also include a user interface that includes I / O devices, such as buttons, a keyboard, a touch screen, a microphone, a speaker, a display, etc., for receiving input and outputting information.
[0169] The verb "meet" in the context of a leveling speed limit is used in this patent application to mean meeting a predetermined condition. For example, the predetermined condition may be reaching and / or exceeding a leveling speed limit value.
[0170] The specific examples provided in the description above should not be construed as limiting the applicability and / or interpretation of the appended claims. The lists and groups of examples provided in the description above are not exhaustive unless otherwise explicitly stated.
Claims
1. A method for processing requests for a people conveyor and / or access control system application programming interface (API), The method includes: Receiving a request through a primary people conveyor and / or access control system application programming interface (API), Determining the target system of the request, Based on the identified target system of the request being a first provider people conveyor and / or access control system, sending the request, for example without processing, to the application programming interface (API) of the first provider people conveyor and / or access control system; Based on the identified target system of the request being a second or additional provider people conveyor and / or access control system, processing the request and sending the processed request to the application programming interface (API) of the second or additional provider people conveyor and / or access control system and / or the control interface of the second or additional provider people conveyor and / or access control system.
2. The method according to claim 1, wherein the processing of the request includes converting and / or modifying the request to make it suitable for the application programming interface (API) of the first, second, and / or additional provider people conveyors and / or access control systems, for example such that the request conforms to the rules or formats of the application programming interface (API) of the first, second, and / or additional provider people conveyors and / or access control systems.
3. The method according to claim 1 or 2, wherein the primary people conveyor and / or access control system application programming interface is connected or communicates with at least one internal application programming interface (API), such as the application programming interface (API) of the first provider people conveyor and / or access control system, and / or is connected or communicates with at least one external application programming interface (API), such as the application programming interface (API) of the second or additional provider people conveyor and / or access control system.
4. The method according to any one of the preceding claims, wherein, The method further includes: Receiving a response from the application programming interface to which the request was sent, and Submitting the response or information related to the response to the device or entity from which the request was received.
5. The method according to claim 4, wherein the method further includes processing the received response and sending the processed response to the device or entity from which the request was received.
6. The method according to claim 5, wherein the processing of the response includes converting and / or modifying the response according to the primary people conveyor and / or access control system application programming interface, for example such that the request conforms to the rules or formats of the primary people conveyor and / or access control system application programming interface (API).
7. The method according to any one of the preceding claims, wherein the processing of the request and / or response is performed using a processor device such as a technology integrator adapter or interface.
8. The method according to any one of the preceding claims, wherein the application programming interface (API) request is related to at least one of the following: an elevator call, a service robot using an elevator, an escalator, and / or an access control system, the status of an elevator, an escalator, and / or access control equipment and / or devices, and / or the status of an elevator, an escalator, and / or access control services.
9. The method according to any one of the preceding claims, wherein the main people conveyor and / or access control system application programming interface (API) includes or is connected to a web portal, the web portal including means for integrating an external system into the people conveyor and / or access control system via the main people conveyor and / or access control application programming interface (API), the external system being, for example, the first provider's people conveyor and / or access control system and / or the second provider's people conveyor and / or access control system.
10. The method according to any one of the preceding claims, wherein the first provider's people conveyor and / or access control system, the second provider's people conveyor and / or access control system, and / or another provider's people conveyor and / or access control system is an elevator (200), an escalator (300), and / or an access control system, including an elevator and control means for the elevator, an escalator and control means for the escalator, and / or access control and control means for access control.
11. An arrangement for processing people conveyor and / or access control system application programming interface (API) requests, such as a server or service, wherein the arrangement is configured to: receive a request via a main people conveyor and / or access control system application programming interface (API), determine the target system of the request, based on the identified target system of the request being the first provider's people conveyor and / or access control system, send the request, for example without processing, to the application programming interface (API) of the first provider's people conveyor and / or access control system, and based on the identified target system of the request being the second or another provider's people conveyor and / or access control system, process the request and send the processed request to the application programming interface (API) of the second or another provider's people conveyor and / or access control system and / or the control interface of the second or another provider's people conveyor and / or access control system.
12. The arrangement according to claim 11, wherein the arrangement is configured to perform the method according to any one of claims 2 - 10.
13. A people conveyor and / or access control system, such as an elevator system (200), an escalator system (300), and / or an access control system, including an arrangement for processing people conveyor system application programming interface (API) requests, such as a server or service, wherein the arrangement is the arrangement according to claim 11 or 12.
14. A computer program comprising instructions which, when executed by a computer such as a server or arrangement, cause the computer to perform the method according to any one of claims 1 - 10.
15. A computer-readable medium comprising the computer program according to claim 14.