GET /v2/apps
Get all the public and owned applications
GET /v2/users/:user_id/apps
Get all the public and owned applications
Return all the public created applications working with the APIv2.
If there is a resource owner, also returns the resource owner applications, public or not.
live_help Notes
chrome_reader_mode
This resource is paginated by 30 items
assignment_ind
This action have additional content with a token resource owner
.
settings Params
Param name | Description |
---|---|
user_id |
optional
. Must be String
The user id or slug |
sort |
optional
. Must be one of: id , name , token , user_id , created_at , updated_at , allowed_origins .
The sort field. Sorted by id desc by default. MoreExample:To sort on apps on the fields updated_at on a descending order and allowed_origins on a ascending order: ...&sort=-updated_at,allowed_origins |
filter |
optional
. Must be one of: id , name , uid , owner_id , website .
Filtering on one or more fields MoreExample:
To filter on apps with the
...&filter[id]=a_value,another_value Filterable fields:
|
range |
optional
. Must be one of: id , name , uid , owner_id , website .
Select on a particular range MoreExample:
To range on apps with the
...&range[website]=min_value,max_value Rangeable fields:
|
page |
optional
. Must be a Hash
The pagination params, as a hash |
page[number] |
optional
. Must be Fixnum
The current page |
page[size] |
optional
. Must be Fixnum
The number of items per page, defaults to 30, maximum 100 |
Examples
GET /v2/apps
200
[
{
"id": 7,
"name": "test intrateam staff oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.377Z",
"updated_at": "2017-11-22T13:43:11.434Z",
"owner": {
"id": 74,
"login": "pamidala",
"url": "https://api.intra.42.fr/v2/users/pamidala"
},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
},
{
"id": 1,
"name": "Intrateam",
"description": "manage all"
}
]
},
{
"id": 6,
"name": "test pedago oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.315Z",
"updated_at": "2017-11-22T13:43:11.369Z",
"owner": {},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
},
{
"id": 5,
"name": "Advanced Tutor",
"description": "Manage skills, cursus and all low level pedagogic data"
}
]
},
{
"id": 5,
"name": "test advanced staff oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.261Z",
"updated_at": "2017-11-22T13:43:11.307Z",
"owner": {},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
}
]
}
]
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/apps"
[
{
"id": 7,
"name": "test intrateam staff oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.377Z",
"updated_at": "2017-11-22T13:43:11.434Z",
"owner": {
"id": 74,
"login": "pamidala",
"url": "https://api.intra.42.fr/v2/users/pamidala"
},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
},
{
"id": 1,
"name": "Intrateam",
"description": "manage all"
}
]
},
{
"id": 6,
"name": "test pedago oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.315Z",
"updated_at": "2017-11-22T13:43:11.369Z",
"owner": {},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
},
{
"id": 5,
"name": "Advanced Tutor",
"description": "Manage skills, cursus and all low level pedagogic data"
}
]
},
{
"id": 5,
"name": "test advanced staff oauth application",
"description": null,
"image": null,
"website": null,
"public": true,
"scopes": [],
"created_at": "2017-11-22T13:43:11.261Z",
"updated_at": "2017-11-22T13:43:11.307Z",
"owner": {},
"rate_limit": 1800,
"roles": [
{
"id": 16,
"name": "Official App",
"description": "Approved application without rate limits"
},
{
"id": 7,
"name": "Basic Staff",
"description": "Member of the staff, can manage community services, closes, exams and access advanced student data"
},
{
"id": 11,
"name": "Advanced Staff",
"description": "Member of the staff, with higher privileges"
}
]
}
]
require "oauth2"
UID = "Your application uid"
SECRET = "Your application secret"
client = OAuth2::Client.new(UID, SECRET, site: "https://api.intra.42.fr")
token = client.client_credentials.get_token
response = token.get("/v2/apps")
response.status
# => 200
response.parsed
# => [{"id"=>7, "name"=>"test intrateam staff oauth application", "description"=>nil, "image"=>nil, "website"=>nil, "public"=>true, "scopes"=>[], "created_at"=>"2017-11-22T13:43:11.377Z", "updated_at"=>"2017-11-22T13:43:11.434Z", "owner"=>{"id"=>74, "login"=>"pamidala", "url"=>"https://api.intra.42.fr/v2/users/pamidala"}, "rate_limit"=>1800, "roles"=>[{"id"=>16, "name"=>"Official App", "description"=>"Approved application without rate limits"}, {"id"=>7, "name"=>"Basic Staff", "description"=>"Member of the staff, can manage community services, closes, exams and access advanced student data"}, {"id"=>11, "name"=>"Advanced Staff", "description"=>"Member of the staff, with higher privileges"}, {"id"=>1, "name"=>"Intrateam", "description"=>"manage all"}]}, {"id"=>6, "name"=>"test pedago oauth application", "description"=>nil, "image"=>nil, "website"=>nil, "public"=>true, "scopes"=>[], "created_at"=>"2017-11-22T13:43:11.315Z", "updated_at"=>"2017-11-22T13:43:11.369Z", "owner"=>{}, "rate_limit"=>1800, "roles"=>[{"id"=>16, "name"=>"Official App", "description"=>"Approved application without rate limits"}, {"id"=>7, "name"=>"Basic Staff", "description"=>"Member of the staff, can manage community services, closes, exams and access advanced student data"}, {"id"=>11, "name"=>"Advanced Staff", "description"=>"Member of the staff, with higher privileges"}, {"id"=>5, "name"=>"Advanced Tutor", "description"=>"Manage skills, cursus and all low level pedagogic data"}]}, {"id"=>5, "name"=>"test advanced staff oauth application", "description"=>nil, "image"=>nil, "website"=>nil, "public"=>true, "scopes"=>[], "created_at"=>"2017-11-22T13:43:11.261Z", "updated_at"=>"2017-11-22T13:43:11.307Z", "owner"=>{}, "rate_limit"=>1800, "roles"=>[{"id"=>16, "name"=>"Official App", "description"=>"Approved application without rate limits"}, {"id"=>7, "name"=>"Basic Staff", "description"=>"Member of the staff, can manage community services, closes, exams and access advanced student data"}, {"id"=>11, "name"=>"Advanced Staff", "description"=>"Member of the staff, with higher privileges"}]}]