Errors generating an SDK for the Twitter and GitHub OpenApi's

[PureKrome]

👋🏻 G'Day! Me again :)

While working on #135 I thought I might also test out some more real world OpenApi's, to get some more data on the effectiveness of Kiota.

Kiota: Tested against version 0.51.

Twitter OpenApi

• Endpoint/API: https://api.twitter.com/2/openapi.json
• Command: .\kiota.exe --openapi https://api.twitter.com/2/openapi.json --additional-data false --language csharp -o TwitterClient -c TwitterApiClient --log-level information --clean-output true
• ✅ Completes and generates an SDK
• ❌ Doesn't compile with a number of errors like:
• REF: https://github.com/twitterdev

GitHub OpenApi

• Endpoint/API: https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json
• Command: .\kiota.exe --openapi https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json --additional-data false --language csharp -o GitHubClient -c ApiClient --log-level information --clean-output true
• ❌ Doesn't generate an SDK.
• https://github.com/github/rest-api-description

---

My rational for testing these two endpoints is because they are very public and well known. Sure, the PetStore is the go-to 'demo', but people might think it's not really 'real-world' and therefore not to be taken really seriously. While if this does work against real world endpoints, if can definitely give it some street-cred! In my opinion ...

[baywet]

As always, thanks for pushing Kiota into unexplored edge cases.

Twitter

Interesting, I had tested recently with this API, but only the v2 I think, and didn't run into these issues.

Authored a pull request to address the issues.

GitHub

 "forks": {
            "type": "array",
            "items": {
            }
          },
          "history": {
            "type": "array",
            "items": {
            }
          }

While this is technically valid JSON schema, it's not enough information. Are we expecting an array of scalars or objects?

[PureKrome]

🐦 Twitter: cheers for the PR. sorry to keep finding these things :(
GitHub: er ... I have no idea? So is this like an issue with their schema? Like, I can open an issue on their github repo and ask them for more clarification? Would you like me to do that?

[baywet]

Don't apologize, your contributions are a great help! Knowing what doesn't work is better than not knowing.
As per GitHub, they already have an issue, and since their descriptions are generated by a bot, I feel like the only way to "contribute" is to jump on the issue and tell them this issue is impacting you as well. github/rest-api-description#214