vfeskov / Gitpunch

Watch for releases on GitHub

Features

• Realtime or daily updates
• Ignore minor, patch or pre-releases (semver)
• Optionally watch starred repos
• Completely open-source

API

POST /api/sign_in

Gets you an authorization token via cookie

Example payload

{
  "email": "[email protected]",
  "password": "testpassword"
}

Responds with user record (see profile) and Set-Cookie header that sets token cookie. The cookie must be sent with subsequent requests for authorization

DELETE /api/sign_out

Unsets token cookie

GET /api/profile

Returns authorized user record

Example response:

{
  "id":"5bd5f53e66785643e93c83a9",
  "email":"[email protected]",
  "frequency":"daily",
  "checkAt":9, // UTC hour
  "accessToken":"tui43sg76bbcbfce178bb682b01d6ebcd8b1c221", // of github
  "watching":true,
  "watchingStars":1, // 0: not watching stars
                     // 1: adding new stars
                     // 2: 1 + removing nonstars
  "alerted":[["angular/angular","7.1.0-beta.1"],["vuejs/vue","v2.5.17"]],
  "repos":[
    {
      "repo":"angular/angular",
      "muted":false,
      "filter":0 // 0: only major releases
                 // 1: major & minor
                 // 2: major, minor & patch
                 // 3: all
    },
    {
      "repo":"vuejs/vue",
      "muted":true,
      "filter":2
    }
  ]
}

PATCH /api/profile

Updates record of authorized user

Any of the params can be send alone or all together:

{
  "frequency":"daily",
  "checkAt":9, // UTC hour
  "watching":true,
  "watchingStars":1, // 0: not watching stars
                     // 1: adding new stars
                     // 2: 1 + removing nonstars
  "repos":[
    {
      "repo":"angular/angular",
      "muted":false,
      "filter":0 // 0: only major releases
                 // 1: major & minor
                 // 2: major, minor & patch
                 // 3: all
    },
    {
      "repo":"vuejs/vue",
      "muted":true,
      "filter":2
    }
  ]
}

Responds with result user record, see profile

POST /api/repos

Adds a repo to authorized user

Params:

{
  "repo":"angular/angular",
  "muted":false,
  "filter":0 // 0: only major releases
             // 1: major & minor
             // 2: major, minor & patch
             // 3: all
}

Responds with all repos of authorized user, example:

{
  "repos":[
    {
      "repo":"angular/angular",
      "muted":false,
      "filter":0 // 0: only major releases
                 // 1: major & minor
                 // 2: major, minor & patch
                 // 3: all
    },
    {
      "repo":"vuejs/vue",
      "muted":true,
      "filter":2
    }
  ]
}

POST /api/repos/bulk

Adds multiple repos to authorized user

Params:

{
  "repos":[
    {
      "repo":"angular/angular",
      "muted":false,
      "filter":0 // 0: only major releases
                 // 1: major & minor
                 // 2: major, minor & patch
                 // 3: all
    },
    {
      "repo":"vuejs/vue",
      "muted":true,
      "filter":2
    }
  ]
}

Responds with all repos of authorized user, see example

PATCH /api/repos/all

Updates all repos of authorized user

Params can be sent alone or all together:

{
  "muted":false,
  "filter":0 // 0: only major releases
             // 1: major & minor
             // 2: major, minor & patch
             // 3: all
}

Responds with all repos of authorized user, see example

PATCH /api/repos/:repo

Updates a single repo of authorized user

Params:

{
  "muted":false,
  "filter":0 // 0: only major releases
             // 1: major & minor
             // 2: major, minor & patch
             // 3: all
}

Responds with all repos of authorized user, see example

DELETE /api/repos/all

Deletes all repos of authorized user

Responds with {repos: []}

DELETE /api/repos/:repo

Deletes a repo of authorized user

Responds with all repos of authorized user, see example

Notifier Stats

Credits

Logo by Sasha Feskova. Special thanks to @soulim and @luziamg

Support GitPunch by reporting bugs, suggesting ideas and starring the project - your feedback really helps me stay motivated ♥