API and XML

Developers
1

Hello everyone,
I am currently creating an application (hikvision support). It needs to receive HTTP POST calls. I have declared the API in the manifest and created my api.js file. The problem is that I am receiving XML messages from the equipment, so the body is empty. Do you know how to fix this?

Best Regards

2

Looks like there’s a hardcoded limitation to only support JSON, so there’s not way to fix it with the built-in app API implementation and you may have to look into running a custom web server to accept these requests.

3

Thanks,
I have already tried this solution, but I cannot open a custom port (3000).

4

That shouldn’t be an problem, there are other apps that do the same. What error are you getting?

5

here my code

const http = require('http');

module.exports = class HikCamIsapiApp extends Homey.App {
   async onInit() {
      this.server = http.createServer(async (req, res) => {…});
      this.server.listen(3000, () => { this.log(‘Serveur HTTP lancé’); });
   }

When i call with curl
curl: (7) Failed to connect to XXXX port 3000 after 30 ms: Couldn’t connect to server

6 
this.log(‘Serveur HTTP lancé’);

Invalid quote characters.

7

yes i know. It’s after copy/past.
In my homey log i have that:
2025-12-21T10:49:08.079Z [log] [HikCamIsapiApp] Serveur HTTP lancé
So it’s seem to be good

But the curl call faild

8

Sounds like a local issue, it’s working fine for me. Or are you using an external URL to connect to Homey?

9

no only local

10

Which homey are you on? Apparently there’s a firewall on 2023?

11

HP2023, and there is no firewall.

12

very strange. Can you send me your code please?

13 
  async onInit() {
    this.server = http.createServer(async (req, res) => {
      this.log('received request');
      res.end('OK');
    });
    this.server.listen(3000, () => { this.log('Serveur HTTP lancé'); });
  }
14

very strange …

15

with homey app run → fail

with homey app install → Success ….

Who know why …?

16

Ohhh, right, you need to use this:

homey app run --remote

Without --remote, your app will not be running on your Homey at all, but instead in a local Docker container.

I’ve asked Athom many times to update the documentation to make this clear, but they simply don’t care.

17

OOOOOOOOOh thank you verrrrrry much :slight_smile:

1 Like