how to add versioning in api

[quayilab]

Hello, I'm new to Resgate and quite a while with Golang. Is it possible to define api with version? For example: /api/v1.0/profile => will be handled by service "profile_v1", and /api/v2.0/profile => will be handled by service "profile_v2"?

If it is, may be an example in Golang? Thanks

[jirenius]

Hi!

Great question! I have no example for it, but it is rather simple.

Are you using the go-res package for Go? If so, then you can just add the v1 (or v2) as a prefix to the service name:

package main

import res "github.com/jirenius/go-res"

func main() {
    s := res.NewService("v1.profile")
    s.Handle("model",
        res.Access(res.AccessGranted),
        res.GetModel(func(r res.ModelRequest) {
            r.Model(map[string]string{
                "message": "Hello, World!",
            })
        }),
    )
    s.ListenAndServe("nats://localhost:4222")
}

And access it with HTTP:

GET /api/v1/profile/model

Though, because dot (.) is used as separator in resource IDs, you will currently not be able to do /v1.0/ (it would become /v1/0/). Instead you can do /v1/ or perhaps /v1_0/.

PS. Currently I am trying to redirect help questions to forum.resgate.io , so if you have more questions, please post them there :). Then I'll use GitHub more for issues and bug reports.

[quayilab]

Thank you for fast response. Yes! that's what I need /v1_0/ is enough for me.