25
Root
7y

Poorly written docs.

I've been fighting with the Epson T88VI printer webconfig api for five hours now.

The official TM-T88VI WebConfig API User's Manual tells me how to configure their printer via the API... but it does so without complete examples. Most of it is there, but the actual format of the API call is missing.

It's basically: call `API_URL` with GET to get the printer's config data (works). Call it with PUT to set the data! ... except no matter what I try, I get either a 401:Unauthorized (despite correct credentials), 403:Forbidden (again...), or an "Invalid Parameter" response.

I have no idea how to do this.

I've tried literally every combination of params, nesting, json formatting, etc. I can think of. Nothing bloody works!

All it would have taken to save me so many hours of trouble is a single complete example. Ten minutes' effort on their part. tops.

asjdf;ahgwjklfjasdg;kh.

Comments
  • 5
    I’ll take poorly written docs over no docs 🙃
    I’m facing a similar issue right now, API is completely undocumented and I’m getting “invalid credentials” 😩
  • 4
    @C0D4 agreed. Still infuriating.
  • 4
    @Ashkin
    That it is, apparently the credentials are right, and are working in a sandbox but I can’t for the life of me make it work.

    I hate APIs sometimes.
  • 0
    Update:
    I've been able to get the PUT calls to work, and get responses back from the printer. However, as I'm only able to update exactly one setting -- not even a setting we use -- I contacted Epson and asked them to look through my Epson wrapper class.

    At 100× $500 printers so far and thousands more in our future (maybe tens of thousands), we're paying them enough they really should write it for us.

    They actually did send us a bulk configure script when we asked. It didn't work for a lot of reasons. Like putting the port AFTER the entire url instead of just the hostname. And misspelled urls. It was also missing most of the examples. It also didn't change the printer settings after fixing it. It was so useless.

    But anyway. Hopefully they'll respond with something I can use. 😟
  • 0
    Update:
    They never did.
Add Comment