Usuário
Representa um usuário cadastrado no Redu.
Atributos
| Atributo | Descrição |
|---|---|
| ID | Identificador do usuário |
| login | Login do usuário |
| 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"
}
]