Fork me on GitHub

Representa um usuário cadastrado no Redu.

Atributos

Atributo Descrição
ID Identificador do usuário
login Login do usuário
email Email cadastrado no Redu
first_name Primeiro nome
last_name Último nome
description Descrição do usuário
favorite_quotation Frase marcante
localization Onde mora
mobile Telefone celular
birthday Data de nascimento
birth_localization Onde nasceu
friends_count Quantidade de contatos
created_at Data de criação
updated_at Data de atualização
social_networks Redes sociais cadastradas
interested_areas Áreas de interesse
thumbnails Thumbnails do usuário. Tamanhos disponíveis: 24×24, 32×32, 48×48, 90×90, 96×96, 110×110 e 160×160

Links

Link Descrição
self Usuário em questão
enrollments Matrículas
statuses Postagens feitas no mural do usuário
timeline Feed de atualizações de todos os murais que tem acesso
contacts Contatos
chats Conversas com seus contatos
connections Conexões com seus contatos

Representação

{
    "last_name": "Lucena",
    "first_name": "Juliana",
    "birth_localization": "Recife, Pernambuco",
    "description": "Graduanda em Ciência da Computação",
    "favorite_quotation": "Frase marcante"
    "social_networks": [
        {
            "profile": "facebook.com/julianamlucena",
            "name": "facebook"
        },
        {
            "profile": "linkedin.com/in/julianalucena",
            "name": "linkedin"
        },
        {
            "profile": "twitter.com/#!/julianalucenaa",
            "name": "twitter"
        }
    ],
    "links": [
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/enrollments",
            "rel": "enrollments"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/statuses",
            "rel": "statuses"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena",
            "rel": "self"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/chats",
            "rel": "chats"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/statuses/timeline",
            "rel": "timeline"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/contacts",
            "rel": "contacts"
        },
        {
            "href": "http://www.redu.com.br/api/users/julianalucena/connections",
            "rel": "connections"
        }
    ],
    "created_at": "2010-09-14T19:25:17-03:00",
    "friends_count": 118,
    "birthday": "1989-05-29",
    "localization": "Recife, Pernambuco",
    "login": "julianalucena",
    "thumbnails": [
        {
            "size": "24x24",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_24/juliana2.png?1351618261"
        },
        {
            "size": "110x110",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_110/juliana2.png?1351618261"
        },
        {
            "size": "32x32",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_32/juliana2.png?1351618261"
        },
        {
            "size": "160x160",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_160/juliana2.png?1351618261"
        },
        {
            "size": "90x90",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_90/juliana2.png?1351618261"
        },
        {
            "size": "48x48",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_48/juliana2.png?1351618261"
        },
        {
            "size": "96x96",
            "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_96/juliana2.png?1351618261"
        }
    ],
    "interested_areas": [
        {
            "name": "Web"
        },
        {
            "name": "Educação"
        },
        {
            "name": "informática"
        }
    ],
    "email": "julianalucenaa@gmail.com",
    "updated_at": "2013-03-26T15:57:57-03:00",
    "id": 8,
    "mobile": ""
}

GET /api/users/:id

Retorna um único usuário com o ID ou login especificado. Tanto o login quanto o ID servem como identificadores únicos para os usuários, por isso podem ser passados como parâmetro aqui.

Autorização

Para visualizar este recurso é necessário ser contato do usuário em questão.

Parâmetros

Parâmetro Descrição Restrições
id ID ou login do usuário em questão N/A

Exemplo

Requisição:

GET /api/users/test_user

Resposta:

{
  "login": "guiocavalcanti",
    "first_name": "Guilherme",
    "links": [
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti",
      "rel": "self"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/enrollments",
      "rel": "enrollments"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses",
      "rel": "statuses"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses/timeline",
      "rel": "timeline"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/contacts",
      "rel": "contacts"
    }
  ],
    "email": "contato@redu.com.br",
    "birthday": "1987-11-24",
    "last_name": "Cavalcanti",
    "friends_count": 132,
    "id": 4,
    "mobile": "+55 (81) 3224-2994",
    "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"
    }
  ],
    "social_networks": [
    {
      "profile": "www.facebook.com/guiocavalcanti",
      "name": "facebook"
    },
    {
      "profile": "br.linkedin.com/in/guiocavalcanti",
      "name": "linkedin"
    },
    {
      "profile": "www.twitter.com/guiocavalcanti",
      "name": "twitter"
    }
  ],
    "localization": "Recife, Brasil",
    "birth_localization": "Recife, Brasil"
}

GET /api/me

Retorna uma representação do resource owner. Resource owner é usuário que autorizou a aplicação a utilizar seus dados.

Exemplo

Requisição:

GET /api/me

Resposta:

{
  "login": "guiocavalcanti",
    "first_name": "Guilherme",
    "links": [
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti",
      "rel": "self"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/enrollments",
      "rel": "enrollments"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses",
      "rel": "statuses"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses/timeline",
      "rel": "timeline"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/contacts",
      "rel": "contacts"
    }
  ],
    "email": "contato@redu.com.br",
    "birthday": "1987-11-24",
    "last_name": "Cavalcanti",
    "friends_count": 132,
    "id": 4,
    "mobile": "+55 (81) 3224-2994",
    "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"
    }
  ],
    "social_networks": [
    {
      "profile": "www.facebook.com/guiocavalcanti",
      "name": "facebook"
    },
    {
      "profile": "br.linkedin.com/in/guiocavalcanti",
      "name": "linkedin"
    },
    {
      "profile": "www.twitter.com/guiocavalcanti",
      "name": "twitter"
    }
  ],
    "localization": "Recife, Brasil",
    "birth_localization": "Recife, Brasil"
}

GET /api/spaces/:space_id/users

Retorna todos os usuários cuja matrícula tem o estado approved no curso ao qual a disciplina está associada. Opcionalmente é possível filtrar os usuários por papeis.

Autorização

É necessário estar matriculado no curso.

Parâmetros

Parâmetro Descrição Restrições
space_id ID da Disciplina N/A
role Papel do usuário no curso Pode ser um dos seguintes papéis: member, teacher, environment_admin, tutor
partial Escolhe uma representação menor para o usuário, mostrando apenas: id, first_name e last_name true

Exemplo

Requisição:

GET /api/space/1/users?role=member

Resposta:

[
{
  "login": "guiocavalcanti",
    "first_name": "Guilherme",
    "links": [
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti",
      "rel": "self"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/enrollments",
      "rel": "enrollments"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses",
      "rel": "statuses"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/statuses/timeline",
      "rel": "timeline"
    },
    {
      "href": "http://www.redu.com.br/api/users/guiocavalcanti/contacts",
      "rel": "contacts"
    }
  ],
    "email": "guilhermec@redu.com.br",
    "birthday": "1987-11-24",
    "last_name": "Cavalcanti",
    "friends_count": 132,
    "id": 4,
    "mobile": "+55 (81) 3224-2994",
    "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"
    }
  ],
    "social_networks": [
    {
      "profile": "www.facebook.com/guiocavalcanti",
      "name": "facebook"
    },
    {
      "profile": "br.linkedin.com/in/guiocavalcanti",
      "name": "linkedin"
    },
    {
      "profile": "www.twitter.com/guiocavalcanti",
      "name": "twitter"
    }
  ],
    "localization": "Recife, Brasil",
    "birth_localization": "Recife, Brasil"
},
{
  "login": "julianalucena",
  "first_name": "Juliana",
  "links": [
  {
    "href": "http://www.redu.com.br/api/users/julianalucena",
    "rel": "self"
  },
  {
    "href": "http://www.redu.com.br/api/users/julianalucena/enrollments",
    "rel": "enrollments"
  },
  {
    "href": "http://www.redu.com.br/api/users/julianalucena/statuses",
    "rel": "statuses"
  },
  {
    "href": "http://www.redu.com.br/api/users/julianalucena/statuses/timeline",
    "rel": "timeline"
  },
  {
    "href": "http://www.redu.com.br/api/users/julianalucena/contacts",
    "rel": "contacts"
  }
  ],
    "email": "juliana@redu.com.br",
    "birthday": "1989-05-29",
    "last_name": "Lucena",
    "friends_count": 84,
    "id": 8,
    "mobile": "",
    "thumbnails": [
    {
      "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_32/twitter2_bigger.png?1297096068",
      "size": "32x32"
    },
    {
      "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/8/thumb_110/twitter2_bigger.png?1297096068",
      "size": "110x110"
    }
  ],
    "social_networks": [
    {
      "profile": "facebook.com/julianamlucena",
      "name": "facebook"
    },
    {
      "profile": "linkedin.com/in/julianalucena",
      "name": "linkedin"
    },
    {
      "profile": "twitter.com/#!/julianalucenaa",
      "name": "twitter"
    }
  ],
    "localization": "Recife, Pernambuco",
    "birth_localization": "Recife, Pernambuco"
},
{
  "login": "jessicab",
  "first_name": "Jéssica",
  "links": [
  {
    "href": "http://www.redu.com.br/api/users/jessicab",
    "rel": "self"
  },
  {
    "href": "http://www.redu.com.br/api/users/jessicab/enrollments",
    "rel": "enrollments"
  },
  {
    "href": "http://www.redu.com.br/api/users/jessicab/statuses",
    "rel": "statuses"
  },
  {
    "href": "http://www.redu.com.br/api/users/jessicab/statuses/timeline",
    "rel": "timeline"
  },
  {
    "href": "http://www.redu.com.br/api/users/jessicab/contacts",
    "rel": "contacts"
  }
  ],
    "email": "jessica@redu.com.br",
    "birthday": "1991-01-10",
    "last_name": "Barbalho",
    "friends_count": 18,
    "id": 443,
    "mobile": "",
    "thumbnails": [
    {
      "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/443/thumb_32/J%C3%A9ssica.jpg?1334865750",
      "size": "32x32"
    },
    {
      "href": "http://s3.amazonaws.com/redu_uploads/users/avatars/443/thumb_110/J%C3%A9ssica.jpg?1334865750",
      "size": "110x110"
    }
  ],
    "social_networks": [
    {
      "profile": "http://www.facebook.com/jessicabarbalho1",
      "name": "facebook"
    },
    {
      "profile": "https://twitter.com/#!/jessicabarbalho",
      "name": "twitter"
    }
  ],
    "localization": "Recife, PE",
    "birth_localization": "Recife, PE"
}
]