Mural

• Canvas
• Links
• Mural
• Matrícula
• AVA
• Aula
• Módulo
• Chat
• Conexão
• Pastas e Arquivos
• Disciplina
• Usuário
• Progresso
• Curso

O Mural é o cerne da comunicação dentro do Redu. Através dele os usuários podem postar comentários, respostas e pedidos de ajuda. Além disso o Mural é o meio pelo qual as movimentações do sistema são mostradas. No contexto da API, qualquer elemento mostrado no Mural é chamado de status.

Tipos de status

O recurso que representa uma movimentação no Redu é o status. Dependendo do tipo de movimentação, o status possui um tipo (diferenciado através do type) diferente.

Todos os tipos de Status possuem as seguintes propriedades:

Tipo Activity

Status com o tipo Activity são um tipo de movimentação explicitamente criada pelo usuário. Por exemplo, um post no mural da disciplina ou do usuário cria um status do tipo Activity. Este é o tipo mais comum de status.

O Status do tipo Activity pode ser respondido por outras pessoas. Tais respostas estão acessíveis através do link answers. Além disso, o Activity se relaciona com user e statusable. Ver exemplos abaixo:

Tipo Help

Bem parecido com o Activity, Status do tipo Help representam pedidos de ajuda ou perguntas dos usuários. Eles só podem ser criados nos murais das aulas (lecture). No fim do dia, Status com o tipo Help têm a mesma função do Activity, só há uma restrição dos locais onde eles podem ser criados e a representação na interface (ver figura).

O Status do tipo Help também pode ser respondido por outras pessoas. Tais respostas estão acessíveis através do link answers. Além disso, o Help se relaciona com user e statusable através de link. Ver exemplos abaixo:

Tipo Answer

Como dito acima, os Activity e Help podem ser respondidos por outros usuários. É aí que precisamos do Status do tipo Answer. Eles se relacionam com um Status através do link in_response_to. Diferente dos Activity e Help, os Answer não podem ser respondidos.

Tipo Log

Este é o único tipo de Status que independe da ação do usuário para serem criados. O Status tipo Log são gerados automáticamente pelo Redu quando certos tipos de ações ocorrem. Por exemplo, quando o usuário atualiza seu perfil no Redu, um Log é criado representando esta ação.

Em geral Logs são utilizados para representar as alterações dos usuários no Redu. As ações que criam Logs são:

• Adição de Aulas num Módulo (logeable_type Lecture)
• Criação de Módulo (logeable_type Subject)
• Criação de Curso (logeable_type Course)
• Matrícula no Curso (logeable_type Enrollment)
• Modificação do perfil do Usuário no Curso (logeable_type User)
• Requisição de conexão no Curso (logeable_type Friendship)

Além dos atributos que o Activity, Help e Answer possuem, o Log possui um atributo logeable_type que representa o tipo do objeto ao qual o Log está associado. Por exemplo, a criação de uma aula gera um Log cujo o logeable_type é Lecture. Além disso, o Log tem associado a sí um link para o logeable. No exemplo dado anteriormente o link logeable conteria o endereço para a aula criada.

GET /api/statuses/:status_id

Retorna um status com o ID especificado.

Parâmetros

GET /api/statuses/:status_id/answers

Retorna as respostas de um status. É aplicado aos tipos Help e Activity.

Parâmetros

POST /api/statuses/:status_id/answers

Cria um status do tipo Answer em resposta a um Activity ou Help.

Parâmetros

GET /api/users/:user_id/statuses

Retorna todos os status do usuário. Também é possível filtrar pelo tipo. Caso :type não seja informado é retornado os status do tipo Activity, Help e Log do usuário.

Parâmetros

Exemplo

Requisição:

GET /api/users/:user_id/statuses?type=Activity

Resposta:

[{
  "type": "Activity",
    "links": [
    {
      "rel": "self",
      "href": "http://www.redu.com.br/api/statuses/34676"
    },
    {
      "rel": "statusable",
      "href": "http://www.redu.com.br/api/spaces/521"
    },
    {
      "rel": "user",
      "href": "http://www.redu.com.br/api/users/guiocavalcanti"
    },
    {
      "rel": "answers",
      "href": "http://www.redu.com.br/api/statuses/34676/answers"
    }
  ],
    "user": {
      "social_networks": [
      {
        "name": "facebook",
        "profile": "www.facebook.com/guiocavalcanti"
      },
      {
        "name": "linkedin",
        "profile": "br.linkedin.com/in/guiocavalcanti"
      },
      {
        "name": "twitter",
        "profile": "www.twitter.com/guiocavalcanti"
      }
      ],
        "thumbnails": [
        {
          "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/4/thumb_32/Guilherme3x4%20copy.jpg?1323711306",
          "size": "32x32"
        },
        {
          "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/4/thumb_110/Guilherme3x4%20copy.jpg?1323711306",
          "size": "110x110"
        }
      ],
        "birthday": "1987-11-24",
        "localization": "Recife, Brasil",
        "first_name": "Guilherme",
        "email": "guilhermec@redu.com.br",
        "links": [
        {
          "rel": "self",
          "href": "http://www.redu.com.br/api/users/guiocavalcanti"
        },
        {
          "rel": "enrollments",
          "href": "http://www.redu.com.br/api/users/guiocavalcanti/enrollments"
        },
        {
          "rel": "statuses",
          "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses"
        },
        {
          "rel": "timeline",
          "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses/timeline"
        },
        {
          "rel": "contacts",
          "href": "http://www.redu.com.br/api/users/guiocavalcanti/contacts"
        }
      ],
        "mobile": "+55 (81) 3333-3333",
        "friends_count": 98,
        "last_name": "Cavalcanti",
        "login": "guiocavalcanti",
        "id": 4,
        "birth_localization": "Recife, Brasil"
    },
    "id": 34676,
    "created_at": "2012-07-02T13:53:50-03:00",
    "text": "Todos os componentes da interface do Redu agora são opensource!\r\n\r\nVocês são livres para utilizar os CSS e JavaScript dentro nas suas aplicações. Para incluir e utilizar basta ir em: http://developers.redu.com.br/ui-components\r\n\r\nNo canto superior direito tem um índice de todos os elementos e sobre como cria-los.",
    "answers_count": 6
}]

GET /api/users/:user_id/statuses/timeline

Retorna todos os status do usuário e dos cursos que o usuário faz parte. Diferente do anterior, aqui são mostradas todas as movimentações que interessam ao usuário. É igual ao que se vê na página inicial do Redu.

Parâmetros

POST /api/users/:user_id/statuses

Cria um status do tipo Activity no Mural do usuário.

Parâmetros

GET /api/spaces/:space_id/statuses/timeline

Retorna todos os status da disciplina e das suas aulas. Diferente do anterior, aqui são agregados tanto as postagens da disciplina quanto as das suas aulas. É igual ao que se vê no mural da disciplina.

Parâmetros

GET /api/spaces/:space_id/statuses

Retorna todos os status do mural de uma disciplina. Há possibilidade de filtrar os status da disciplina pelo tipo. É importante perceber que os posts listados aqui se limitam àqueles postado diretamente na disciplina.

Parâmetros

POST /api/spaces/:space_id/statuses

Cria um status no Mural da disciplina.

Parâmetros

Mural de uma Aula

GET /api/lectures/:lecture_id/statuses

Retorna todos os status do mural de uma aula. Pode se filtrar os status de uma aula pelo tipo.

Parâmetros

POST /api/lectures/:lecture_id/statuses

Cria um status no Mural da aula. Somente neste caso é permitido criar um Help (pedido de ajuda).

Parâmetros

DELETE /api/statuses/:status_id

Remove o status.

Parâmetros