[Meta] Improvements to the API

[bkcsoft]

Meta-issue for everything API related. Please don't close until API is done, and don't set a milestone either since it's long-running

Original Gogs-issue

Related Issues:

• CI/CD Status ( Gogs Issue )
• PR ([API] Pull Requests #248)
• OAuth-support for API
  • Related Issue: Integrate an OAuth2 provider #27
• Stars (WIP)
• Inconsistencies
  • Issue Comments
  • Issue Labels
  • PR JSON Object
• Releases New PR
• User/Org Repo Listing

Not APIs but related:

• RSS Support ( Gogs Issue )
  • Required for Activity Feed API
  • Version Notification
• Plugin Infrastructure
  • Should really go in go-gitea/proposals, drafts are already done.
• React UI
  • As I mentioned in that Issue, a complete API would allow others to implement their own UIs if necessary
  • Also ties in with Responsive UI #35

Will add more to this list as they keep coming.

This also requires us to fork gogits/go-gogs-client done 😄

---

Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.

[bkcsoft]

@tboerger Should this be a "Project" instead maybe?

[hhenkel]

One point I already mentioned on the gitter channel yesterday, IMHO there is a need for automatic documentation (from code / comments in the code) of the api. I think this should be added to this list, there is an initial issue in go-gogs-client mentioning one of the current issues with the docs: gogs/go-gogs-client#46

It seems swagger is the most popular solution currently and it seems there is a go implementation

[metalmatze]

Yep 👍 for swagger

[tboerger]

Maybe a project should be better to keep an overview of missing parts.

[bkcsoft]

@tboerger AFAIK it's hard to make generic comments (like @hhenkel just did) on a Project?

[tboerger]

We should create issues for all of that.

[lunny]

I think this should be the emphasis of v1.1. So we have to list all the APIs should github have. And implements it one by one. For example, we can implement https://developer.github.com/v3/repos/statuses first?

[bkcsoft]

@lunny I have a few PRs coming, but I'll continue with the rest of the API after that starting with Status API :)

[lunny]

+1