Can not build API in GO using https://github.com/deepmap/oapi-codegen about api-docs HOT 7 CLOSED

Going to add some special notes to the docs about using the bundled reference.

from api-docs.

Take a look at https://github.com/ogen-go/ogen - it looks like a more active and (maybe) better openapi generator for go.
It still complains about a few problems in the spec, but that can be fixed by just removing a few (possible wrong?) fields:

diff --git a/models/Cooldown.json b/models/Cooldown.json
index f10e582..abbc344 100644
--- a/models/Cooldown.json
+++ b/models/Cooldown.json
@@ -20,8 +20,7 @@
     "expiration": {
       "type": "string",
       "format": "date-time",
-      "description": "The date and time when the cooldown expires in ISO 8601 format",
-      "minimum": 0
+      "description": "The date and time when the cooldown expires in ISO 8601 format"
     }
   },
   "required": [
diff --git a/models/Survey.json b/models/Survey.json
index 7cd4f44..178ab48 100644
--- a/models/Survey.json
+++ b/models/Survey.json
@@ -22,8 +22,7 @@
     "expiration": {
       "type": "string",
       "format": "date-time",
-      "description": "The date and time when the survey expires. After this date and time, the survey will no longer be available for extraction.",
-      "minimum": 0
+      "description": "The date and time when the survey expires. After this date and time, the survey will no longer be available for extraction."
     },
     "size": {
       "type": "string",

from api-docs.

@ptxmac thanks for the suggestion. I'll take a look at it when I get some time.

from api-docs.

Thanks for bringing this up! I think other languages had similar issues with references. We'll update the docs with an example people in the community found: you can get the bundled export here from stoplight:
https://stoplight.io/api/v1/projects/spacetraders/spacetraders/nodes/reference/SpaceTraders.json?fromExportButton=true&snapshotType=http_service&deref=optimizedBundle

from api-docs.

This "minimum": 0 also caused problems using smithy-translate. After removing this entry the translation into a smithy-model worked.

from api-docs.

I think we can remove these fields. Do we have any idea why the tooling doesn't support minimum 0?

from api-docs.

Guess it doesn't make sense to have a string of type dateTime have a minimum-value of 0. maybe it'd work if you give it a minimum value of a valid date string? But tbh I wouldn't bother and just remove it :)

from api-docs.