Dear community and TP-link

What a shitshow is your API documentation. I followed the guide provided by TP-LINK to establish an external portal server connection. After hours of searching the only thing I get is errorcode -1 / general error.

I opened up the logs and this is what is happening:

Caused by: com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot construct instance of `com.tplink.omada.service.vo.portal.ExtAuthReqVO` (although at least one Creator exists): no String-argument constructor/factory method to deserialize from String value ('clientMac=C0-06-C3-FF-EB-E2&apMac=14-7D-DA-A9-CA-B5&ssidName=Omada+Portal&radioId=1000&site=q9fsGe0P&time=3600000&authType=0')

or

Caused by: com.fasterxml.jackson.core.JsonParseException: Unrecognized token 'clientMac': was expecting ('true', 'false' or 'null')
 at [Source: (String)"clientMac=C0-06-C3-FF-EB-E2&apMac=14-7D-DA-A9-CA-B5&ssidName=Omada+Portal&radioId=1000&site=q9fsGe0P&time=3600000&authType=0"; line: 1, column: 10]

I tried multiple variants:

clientMac=C0-06-C3-FF-EB-E2&apMac=14-7D-DA-A9-CA-B5&ssidName=Omada+Portal&radioId=1000&site=q9fsGe0P&time=3600000&authType=0

clientMac=C0-06-C3-FF-EB-E2;apMac=14-7D-DA-A9-CA-B5;ssidName=Omada+Portal;radioId=1000&site=q9fsGe0P;time=3600000;authType=0

and so on...

Update your freaking guides please and deliver some proper api documentation.

Thanks