Apidog is caching OpenAPI docs

Get Support
1

I noticed, that after import(or sync) OpenAPI docs from URL, the HTTP response is cached and Apidog is not reacting on any change in the documentation, showing that there are “no change” documentation unless the URL is changed.
After I appended ?version=1 to my URL, the “new” URL was parsed successfully and new/changed endpoints showed up.

It doesn’t seem to be right to cache an API documenation.
How can I avoid that?

2

Did you mean the share documents didn’t changed even after refresh page in the browser after you re-imported. About the changed URL, did you mean the URL in the browser instead of the URL of the API endpoint.

Please provide more details or screenshots to clarify the issue.

3

Sorry for ambiguous description.
Under “URL” I mean the URL I’m importing Open API schema from.
Here are the steps I did:

  1. I created empty project
  2. I Imported API from URL (say https://server.com/openapi.json), 10 endpoints created
  3. Updated my API specification in Open API JSON file, added 3 endpoints.
  4. I tried to re-import the API from the same URL, Apidog says, that there are no changes, no endpoints added, neither updated.

Trying to debug, I appended ?version=1 to the URL, like “https://server.com/openapi.json?version=1” and tried to import again, after that, 3 endpoints created as expected.

I think your parser is caching my API doc file.
If this doesn’t seem to be true, then tomorrow I will provide a real link to the file and let’s try to reproduce the problem together.
It is worth to say that the problem appears sometimes, not always.

P.S I checked, the server on which the JSON file is located does not cache the content on its side.

4

Thanks for the detailed bug report

I will forward this to engineer as a remind. Normally the bug will be fixed within one week and release alongside with the weekly release Apidog version.

5

Hello, before resolving this issue, I need your help to confirm. You can first open your OpenAPI URL file in the browser, and then update your OpenAPI file, such as adding a few interfaces. After the update is completed, open the URL again in the browser to see if the returned content has the interface you just added. At the same time, take a screenshot of the content in the header to confirm if there are any cache related response headers.

6

I have a similar problem with OpenApi

7

I used to only click on import now, but the removed API not disapeears

also, a query string that was removed did not updated.

after run override for a singular endpoint, the description cleared also. Luckly i have saved

image.png
image.png1151×967 89 KB

image.png
image.png1151×967 89 KB

8

Thanks for the feedback. Scheduled Import will support synchronizing updates and deletions in the future.

9

merge is the right way to do it, right ?