Skip to main content

Integration, Extension & APIs

Discussion board where members can learn more about Integration, Extensions and API’s for Qlik Sense.

Announcements
QlikWorld 2023, a live, in-person thrill ride. Save $300 before February 6: REGISTER NOW!
cancel
Showing results for 
Search instead for 
Did you mean: 
stefanstoichev123
Contributor III
Contributor III

SaaS REST API - Automations endpoints questions (documentation issues?)

Looking at the Automations API and have few questions:

  • what is the difference between automation, id and automationId in the path parameters?
  • what is the difference between run and runId in the path parameters?
  • (probably because of the first point) why are there duplicate endpoints? for example
    • /v1/automations/{automation}/actions/copy and /v1/automations/{id}/actions/copy
    • /v1/automations/{automation}/runs/{run}/actions/retry and /v1/automations/{automationId}/runs/{runId}/actions/retry
  • some endpoints are returning id and some guid (as automation id). Which is the correct one? For example:

         stefanstoichev123_1-1660321170762.png

         and

        stefanstoichev123_2-1660321192807.png

 

Is all of the issues just documentation ones or there are difference endpoints (for some reason)?

Regards!

Stefan

Labels (2)
2 Solutions

Accepted Solutions
DaveChannon
Employee
Employee

Thanks for posting this @stefanstoichev123 

Appreciate that this was a while ago, so for others who might find this post please note that we have improved the documentation for this API and will continue to do so.

GUIDs now shows as IDs, with the exception of the usage endpoint.

I've raised another improvement to tidy up the {automationId} on runs into {id} to align with the rest of the endpoints on https://qlik.dev/apis/rest/automations.

Thanks again

View solution in original post

DaveChannon
Employee
Employee

All endpoints have now been updated and are consistent on https://qlik.dev/apis/rest/automations 

davechannon_0-1674730736984.png

 

Thanks again for the feedback!

View solution in original post

6 Replies
DaveChannon
Employee
Employee

Thanks for posting this @stefanstoichev123 

Appreciate that this was a while ago, so for others who might find this post please note that we have improved the documentation for this API and will continue to do so.

GUIDs now shows as IDs, with the exception of the usage endpoint.

I've raised another improvement to tidy up the {automationId} on runs into {id} to align with the rest of the endpoints on https://qlik.dev/apis/rest/automations.

Thanks again

DaveChannon
Employee
Employee

All endpoints have now been updated and are consistent on https://qlik.dev/apis/rest/automations 

davechannon_0-1674730736984.png

 

Thanks again for the feedback!

stefanstoichev123
Contributor III
Contributor III
Author

Great! Thank you very much @DaveChannon 

 

Is there any official way to follow the SaaS API changes in details? I have an workaround for myself but just asking 🙂

 

Also ... here is the best way to report issues (if any) with SaaS API?

 

Stefan

DaveChannon
Employee
Employee

No out-of-the-box method as yet. As you've alluded you could watch the API specs in the meantime but we know we need to make it easier to follow 🙂 Do you have any examples of companies who make it really easy to follow API changes?

For reporting issues, best way is a support case through the support portal. We do try and monitor the community here too for those who don't have access to the portal, but there's no guarantee that it'll get picked up.

stefanstoichev123
Contributor III
Contributor III
Author

Personally I went the "dummy" way - web scrape qlik.dev and download the specs for each endpoint. Then combine the specs and create a valid swagger schema and commit/push to a repo (all executed by GitHub Action).

 

Its not nice but its working for now 🙂

 

Stefan

DaveChannon
Employee
Employee

Functional is good! 😉