Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Recurly api v3 support #127

Open
rv-rringler opened this issue Sep 3, 2019 · 4 comments
Open

Recurly api v3 support #127

rv-rringler opened this issue Sep 3, 2019 · 4 comments

Comments

@rv-rringler
Copy link

Are there plans to add support for Recurly's v3 api that is being released in october?

@cristiangraz
Copy link
Member

I'm not aware of anyone who is working on it. I just looked through the docs briefly and it seems like it should be a fairly easy transition to V3 -- most of the structs will stay mostly the same. Mostly just a time consuming process to update all of the test files, add JSON struct tags, etc.

The test structure in the library should allow all of the tests to pass with virtually no changes beyond the NewTestAccount etc test methods -- especially if the URLs and HTTP methods are staying the same between v2.x and v3.

I've added a help wanted label in case you or someone else would like to take it on. If no one has taken it in the coming months, and I have some extra time available to take it on, I can potentially implement it.

@bhelx
Copy link
Contributor

bhelx commented Oct 4, 2019

Recurly engineer here. I am planning on releasing an official Go client. We do have a prototype done but I'm not expecting it to get polished and documented until later this year. I can't give a specific timeframe yet.

The V3 API has many similarities but I think it would be pretty ambitious to port a V2 client to it. This library is architected quite well, so it might be possible. I couldn't comment on a specific level of effort. We took this as an opportunity to design new, simpler clients though.

One thing I'd like to point out, we now use OpenAPI to fully describe the V3 API. Leveraging this document has made bootstrapping and maintaining the libraries a lot easier. If you do decide to attempt this, I would suggest you start with that document. Here is the spec for the first GA version coming out next week: https://developers.recurly.com/openapi/v2019-10-10.yaml

@bhelx
Copy link
Contributor

bhelx commented Oct 4, 2019

I also wanted to point out that V2 will still be supported for a long time and these maintainers have done a great job of keeping up to date, so don't feel a lot of pressure to upgrade this year :)

@bhelx
Copy link
Contributor

bhelx commented May 4, 2020

Hey everyone, we've finally gotten around to preparing a Go client for V3. We've released a beta version here: https://github.com/recurly/recurly-client-go

Like the other V3 clients, parts of the codebase are generated from the OpenAPI schema to keep everything documented and up-to date. We still have a few planned improvements to make before we go GA, but we're also seeking feedback on any interface changes we should make as once we go GA, they will be much harder to change. If you are interested, please try it out and give us some feedback. You can file issues or email us at [email protected]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants