1. 42 Api 2.0
  2. Closes
  3. index

GET /v2/closes
Return all the closes

GET /v2/users/:user_id/closes
Return all the closes of the given User

live_help Notes

assignment This action requires one of theses roles: Basic staff
chrome_reader_mode This resource is paginated by 30 items
group_work Requires following application scopes: tig

settings Params

Param name Description
user_id optional . Must be String

The user id or slug
sort optional . Must be one of: id, user_id, closer_id, reason, state, created_at, updated_at, kind, end_at, jid.

The sort field. Sorted by created_at desc, id desc by default.

Example:

To sort on closes on the fields end_at on a descending order and jid on a ascending order: 

...&sort=-end_at,jid
filter optional . Must be one of: id, user_id, closer_id, reason, state, created_at, updated_at, kind, end_at, jid, campus_id, end.

Filtering on one or more fields

Example:

To filter on closes with the id field matching a_value or another_value: 

...&filter[id]=a_value,another_value

Filterable fields:
  • id (standard field)
  • user_id (standard field)
  • closer_id (standard field)
  • reason (standard field)
  • state (standard field)
  • created_at (standard field)
  • updated_at (standard field)
  • kind (standard field)
  • end_at (standard field)
  • jid (standard field)
  • campus_id : .
  • end (standard field)
range optional . Must be one of: id, user_id, closer_id, reason, state, created_at, updated_at, kind, end_at, jid.

Select on a particular range

Example:

To range on closes with the jid field between min_value and max_value: 

...&range[jid]=min_value,max_value

Rangeable fields:
  • id
  • user_id
  • closer_id
  • reason
  • state
  • created_at
  • updated_at
  • kind
  • end_at
  • jid
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

 
GET /v2/closes
200
[
  {
    "id": 3,
    "reason": "Connecticut giants",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.888Z",
    "updated_at": "2017-11-22T13:42:20.987Z",
    "end_at": null,
    "community_services": [
      {
        "id": 2,
        "duration": 14400,
        "schedule_at": "2017-11-28T06:00:00.000Z",
        "occupation": "West Virginia lions",
        "state": "schedule",
        "created_at": "2017-11-22T13:42:20.944Z",
        "updated_at": "2017-11-22T13:42:21.007Z"
      }
    ],
    "user": {
      "id": 82,
      "login": "kyren",
      "url": "https://api.intra.42.fr/v2/users/kyren"
    },
    "closer": {
      "id": 2,
      "login": "andre",
      "url": "https://api.intra.42.fr/v2/users/andre"
    }
  },
  {
    "id": 2,
    "reason": "Florida druids",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.695Z",
    "updated_at": "2017-11-22T13:42:20.857Z",
    "end_at": null,
    "community_services": [
      {
        "id": 1,
        "duration": 14400,
        "schedule_at": "2017-11-27T11:00:00.000Z",
        "occupation": "North Carolina spirits",
        "state": "schedule",
        "created_at": "2017-11-22T13:42:20.806Z",
        "updated_at": "2017-11-22T13:42:20.876Z"
      }
    ],
    "user": {
      "id": 114,
      "login": "darmaul",
      "url": "https://api.intra.42.fr/v2/users/darmaul"
    },
    "closer": {
      "id": 3,
      "login": "gargamel",
      "url": "https://api.intra.42.fr/v2/users/gargamel"
    }
  },
  {
    "id": 1,
    "reason": "Florida druids",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.695Z",
    "updated_at": "2017-11-22T13:42:20.857Z",
    "end_at": "2017-11-24T13:42:20.857Z",
    "community_services": [],
    "user": {
      "id": 114,
      "login": "darmaul",
      "url": "https://api.intra.42.fr/v2/users/darmaul"
    },
    "closer": {
      "id": 3,
      "login": "gargamel",
      "url": "https://api.intra.42.fr/v2/users/gargamel"
    }
  }
]
curl  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/closes"

[
  {
    "id": 3,
    "reason": "Connecticut giants",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.888Z",
    "updated_at": "2017-11-22T13:42:20.987Z",
    "end_at": null,
    "community_services": [
      {
        "id": 2,
        "duration": 14400,
        "schedule_at": "2017-11-28T06:00:00.000Z",
        "occupation": "West Virginia lions",
        "state": "schedule",
        "created_at": "2017-11-22T13:42:20.944Z",
        "updated_at": "2017-11-22T13:42:21.007Z"
      }
    ],
    "user": {
      "id": 82,
      "login": "kyren",
      "url": "https://api.intra.42.fr/v2/users/kyren"
    },
    "closer": {
      "id": 2,
      "login": "andre",
      "url": "https://api.intra.42.fr/v2/users/andre"
    }
  },
  {
    "id": 2,
    "reason": "Florida druids",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.695Z",
    "updated_at": "2017-11-22T13:42:20.857Z",
    "end_at": null,
    "community_services": [
      {
        "id": 1,
        "duration": 14400,
        "schedule_at": "2017-11-27T11:00:00.000Z",
        "occupation": "North Carolina spirits",
        "state": "schedule",
        "created_at": "2017-11-22T13:42:20.806Z",
        "updated_at": "2017-11-22T13:42:20.876Z"
      }
    ],
    "user": {
      "id": 114,
      "login": "darmaul",
      "url": "https://api.intra.42.fr/v2/users/darmaul"
    },
    "closer": {
      "id": 3,
      "login": "gargamel",
      "url": "https://api.intra.42.fr/v2/users/gargamel"
    }
  },
  {
    "id": 1,
    "reason": "Florida druids",
    "state": "unclose",
    "created_at": "2017-11-22T13:42:20.695Z",
    "updated_at": "2017-11-22T13:42:20.857Z",
    "end_at": "2017-11-24T13:42:20.857Z",
    "community_services": [],
    "user": {
      "id": 114,
      "login": "darmaul",
      "url": "https://api.intra.42.fr/v2/users/darmaul"
    },
    "closer": {
      "id": 3,
      "login": "gargamel",
      "url": "https://api.intra.42.fr/v2/users/gargamel"
    }
  }
]
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/closes")
response.status
# => 200
response.parsed
# => [{"id"=>3, "reason"=>"Connecticut giants", "state"=>"unclose", "created_at"=>"2017-11-22T13:42:20.888Z", "updated_at"=>"2017-11-22T13:42:20.987Z", "end_at"=>nil, "community_services"=>[{"id"=>2, "duration"=>14400, "schedule_at"=>"2017-11-28T06:00:00.000Z", "occupation"=>"West Virginia lions", "state"=>"schedule", "created_at"=>"2017-11-22T13:42:20.944Z", "updated_at"=>"2017-11-22T13:42:21.007Z"}], "user"=>{"id"=>82, "login"=>"kyren", "url"=>"https://api.intra.42.fr/v2/users/kyren"}, "closer"=>{"id"=>2, "login"=>"andre", "url"=>"https://api.intra.42.fr/v2/users/andre"}}, {"id"=>2, "reason"=>"Florida druids", "state"=>"unclose", "created_at"=>"2017-11-22T13:42:20.695Z", "updated_at"=>"2017-11-22T13:42:20.857Z", "end_at"=>nil, "community_services"=>[{"id"=>1, "duration"=>14400, "schedule_at"=>"2017-11-27T11:00:00.000Z", "occupation"=>"North Carolina spirits", "state"=>"schedule", "created_at"=>"2017-11-22T13:42:20.806Z", "updated_at"=>"2017-11-22T13:42:20.876Z"}], "user"=>{"id"=>114, "login"=>"darmaul", "url"=>"https://api.intra.42.fr/v2/users/darmaul"}, "closer"=>{"id"=>3, "login"=>"gargamel", "url"=>"https://api.intra.42.fr/v2/users/gargamel"}}, {"id"=>1, "reason"=>"Florida druids", "state"=>"unclose", "created_at"=>"2017-11-22T13:42:20.695Z", "updated_at"=>"2017-11-22T13:42:20.857Z", "end_at"=>"2017-11-24T13:42:20.857Z", "community_services"=>[], "user"=>{"id"=>114, "login"=>"darmaul", "url"=>"https://api.intra.42.fr/v2/users/darmaul"}, "closer"=>{"id"=>3, "login"=>"gargamel", "url"=>"https://api.intra.42.fr/v2/users/gargamel"}}]