Welcome to laravel-g4t-swagger-auto-generate Discussions!

[hussein4alaa]

👋 Welcome!

We’re using Discussions as a place to connect with other members of our community. We hope that you:

• Ask questions you’re wondering about.
• Share ideas.
• Engage with other community members.
• Welcome others and are open-minded. Remember that this is a community we
  build together 💪.

To get started, comment below with an introduction of yourself and tell us about what you do with this community.

[IsaMohamud]

Hello hussein,
I was wondering if it is possible to change the auto generated swagger api documentation.
In my case there are some endpoints not correctly documented, which causes errors in the execute state.

[hussein4alaa]

Hello IsaMohamud,
Welcome
Can you provide me the routes code from your routes file?
And if you can give me the error messages that you see

[IsaMohamud]

In the above image you can see the error message, which indicates that certain fields are missing. This is because the api request body is structured as follows:
{
"onderwijsprogramma.uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"onderwijsprogramma.naam": "string",
"onderwijsprogramma.code": "string",
"onderwijsprogramma.cohort": "string",
"onderwijsprogramma.niveau": "string",
"onderwijsprogramma.uitvoeringsvorm": "string",
"onderwijsprogramma.duur": "string",
"onderwijsprogramma.duur_eenheid": "string",
"onderwijsprogramma.indicatie": "string",
"onderwijsprogramma.programma_type": "string",
"versie.naam": "string",
"versie.omschrijving": "string",
"versie.commerciele_naam": "string",
"versie.startdatum": "2023-10-09",
"versie.einddatum": "2023-10-09"
}

However the controller method of the route being invoked expects the following format:

{
"onderwijsprogramma": {
"uuid": "152bc989-33f3-373f-81bf-5f9f188ef2b1",
"naam": "voluptatem",
"code": "porro",
"cohort": "blanditiis",
"niveau": "quo",
"uitvoeringsvorm": "odio",
"duur": 20,
"duur_eenheid": "fugit",
"indicatie": "ipsam",
"programma_type": "rerum",
},
"versie": {
"naam": "delectus",
"omschrijving": "omnis",
"commerciele_naam": "nisi",
"startdatum": "2023-09-28T08:48:57",
"einddatum": "2023-09-28T08:48:57"
}
}

I think it doesn't have to do with something in the routes. That is just a simple code to create an apiResource.
Like this: Route::apiResource('onderwijsprogrammas', OnderwijsprogrammasController::class);

[hussein4alaa]

please use "g4t/swagger": "2.0.5",

[IsaMohamud]

No problem, you are welcome. I see the potential in this package, so i don't mind to invest some time to it.

The next problem i got, has to do with reaching the swagger page /documentation/swagger.
See below image.

[hussein4alaa]

i think this issue in your middleware

[IsaMohamud]

I don't think that is the problem. Nothing is changed in the code and i only updated to a new version of your library.
With the older version i don't have this issue.

It has something to do with the response that is sent with the endpoint /swagger/documentation. My middleware can't handle it.

[IsaMohamud]

In the above image you can see the last item of the error stack. Maybe it is something because of the double [] that cannot be used
on a string?

[IsaMohamud]

Hello hussein,

Do you already have a solution for the problem? I still think the problem has something to do with the function generateSchemaNested,
where the following line of code gives an error: $current = &$current[$nestedKey]['properties'];