"We offer new support options and therefor the forums are now in read-only mode! Please check out our Support Center for more information." - Vuforia Engine Team

We need better VWS documentation

By giraffeslacks on Fri, 12/28/2018 - 18:45

Hello,

This is my first post and, unfortunately, it's because of being unable to authenticate to VWS. I don't use PHP and I don't use Java so the samples are of little value to me. Which brings up the first question. Why are the samples not in C#?

The second question, and the real reason I'm here, is why these pages lack so many details, plain examples, and are out of date (e.g. Some errors returned are different than what is listed.)?

https://library.vuforia.com/content/vuforia-library/en/articles/Training/Using-the-VWS-API.html

https://library.vuforia.com/articles/Solution/Using-the-VuMark-Instance-Generation-API

For example, the documentation doesn't say what "Request-Path" is. There should also be an example using real (but no longer valid) access key and secret key.

I spent three hours last night trying to get this to work but continue to get "AuthenticationFailure". I am 99% sure I'm doing everything correctly but surely I'm doing something wrong.

I hope to hear from someone soon! I'm really excited to keep making progress on my app (which is why I spent three hours last night)! :)

Hello,

Thanks for the feedback, and apologies for the inconvenience with documentation. Some of the issues you've pointed out will be resolved soon (return codes), and others I have opened tickets to have clarified (Request-Path).

Hello,

I found a hint in the PHP samples for the correct format of "Request-Path":

private $url = "https://vws.vuforia.com";
private $requestPath = "/targets/";

Hi medabit,

Thanks for the update. Much appreciated.

Hello,

Have you tried to access the VuMark generation API with a database under a dev license and it failed? I'm checking to confirm this restriction, but I was under the impression that it would work but with instance generation limits (only 100 can be created for a given database).

Hello @giraffeslacks,

I've confirmed with our operations team that you *cannot* access VWS APIs for generation of VuMarks instances using a Developer license.

Thanks,

Vuforia Engine Support

@medabit

It's true you can create 100 VuMarks but that's only manually through the web portal and, like you said, no API access.

Hello,

I've raised this issue with our product team to see if we can adjust the Developer license such that it would allow for VuMark VWS API access, as well. Unfortunately, I have no timeline.

Thanks,

Vuforia Engine Support

Hi,

Hi, Were you ever able to get the developer license adjusted to also have API access? I keep getting 403: LicenseCheckFailed. Thanks!

Hi @zelmigreyling

Unfortunately not. the developer license does *not* provide access to API.

Thank you.

Vuforia Engine Support

Hi there, which licenses does

Hi there, which licenses does provide VuMark Generation API access.

Hi @natalieausmeier,

As far as I know you need a Pro License to access the API.

For questions, please reach out to our Sales department.

Thank you.

Vuforia Engine Support

I strongly second the need

I strongly second the need for some more comprehensive documentation around the VuMark Instance Generation API, please. I'm having exactly the same difficulties giraffeslacks did.

Some issues that are troubling me:

Hello @kierenj,

There is a VuMark instance generation sample, called generate_vumark_instance.py, available here: https://developer.vuforia.com/downloads/samples. Check the bottom of the page.