Tipos de eventos do GitHub

Para a API de eventos de GitHub, saiba sobre cada tipo de evento, a ação de acionamento em GitHub e as propriedades exclusivas de cada evento.

Neste artigo

A API de eventos pode retornar diferentes tipos de eventos acionados por atividades no GitHub. Cada resposta de evento contém propriedades compartilhadas, mas tem um objeto payload exclusivo determinado pelo tipo de evento. As propriedades comuns do objeto Event descrevem as propriedades compartilhadas por todos os eventos, e cada tipo de evento descreve as propriedades payload exclusivas do evento específico.

Propriedades comuns do objeto de evento

Os objetos de evento retornados dos pontos de extremidade da API de eventos têm a mesma estrutura.

Nome do atributo da API do evento	Type	Descrição
`id`	`integer`	Identificador exclusivo do evento.
`type`	`string`	O tipo do evento. Os eventos usam PascalCase para o nome.
`actor`	`object`	O usuário que acionou o evento.
`actor.id`	`integer`	O identificador único para o ator.
`actor.login`	`string`	O nome de usuário do ator.
`actor.display_login`	`string`	O formato de exibição específico do nome de usuário.
`actor.gravatar_id`	`string`	O identificador único do perfil Gravatar para o ator.
`actor.url`	`string`	A URL da API REST usada para recuperar o objeto do usuário, que inclui informações adicionais sobre o usuário.
`actor.avatar_url`	`string`	A URL da imagem do perfil do ator.
`repo`	`object`	O objeto de repositório onde ocorreu o evento.
`repo.id`	`integer`	O identificador único do repositório.
`repo.name`	`string`	O nome do repositório, que inclui o proprietário e o nome do repositório. Por exemplo, `octocat/hello-world` é o nome do repositório `hello-world` pertencente à conta pessoal `octocat`.
`repo.url`	`string`	A URL da API REST usada para recuperar o objeto do repositório, que inclui informações adicionais do repositório.
`payload`	`object`	O objeto da carga de eventos é único para o tipo de evento. Confira o tipo de evento abaixo para ver o objeto `payload` da API de evento.
`public`	`boolean`	Se o evento é visível a todos os usuários.
`created_at`	`string`	A data e hora em que o evento foi disparado. O formato segue a ISO 8601.
`org`	`object`	A organização que foi escolhida pelo ator para executar uma ação que dispara o evento. A propriedade será exibida no objeto de evento somente se for aplicável.
`org.id`	`integer`	O identificador exclusivo da organização.
`org.login`	`string`	O nome da organização.
`org.gravatar_id`	`string`	O identificador exclusivo do perfil da organização no Gravatar.
`org.url`	`string`	A URL da API REST usada para recuperar o objeto de organização, que inclui informações adicionais da organização.
`org.avatar_url`	`string`	A URL da imagem de perfil da organização.

Exemplo de objeto de evento WatchEvent

Este exemplo mostra o formato da resposta WatchEvent ao usar a API de Eventos.

HTTP/2 200
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "type": "WatchEvent",
    "public": false,
    "payload": {
    },
    "repo": {
      "id": 3,
      "name": "octocat/Hello-World",
      "url": "https://api.github.com/repos/octocat/Hello-World"
    },
    "actor": {
      "id": 1,
      "login": "octocat",
      "gravatar_id": "",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "url": "https://api.github.com/users/octocat"
    },
    "org": {
      "id": 1,
      "login": "github",
      "gravatar_id": "",
      "url": "https://api.github.com/orgs/github",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif"
    },
    "created_at": "2011-09-06T17:26:27Z",
    "id": "12345"
  }
]

CommitCommentEvent

Um comentário de commit foi criado. O tipo de atividade é especificado na propriedade action do objeto de conteúdo. Para obter mais informações, confira Pontos de extremidade da API REST para comentários do commit.