live_help Notes

chrome_reader_mode This resource is paginated by 30 items

settings Params

Param name Description
cursus_id optional . Must be String

The cursus id or slug

user_id optional . Must be String

The user id or slug

tag_id optional . Must be String

The tag id

sort optional . Must be one of: id, name, author_id, kind, created_at, updated_at, pinned_at, locked_at, pinner_id, locker_id, language_id, write_at, message_id, answer_id.

The sort field. Sorted by updated_at desc by default.

Example:

To sort on topics on the fields message_id on a descending order and answer_id on a ascending order:

...&sort=-message_id,answer_id

filter optional . Must be one of: id, name, author_id, kind, created_at, updated_at, pinned_at, locked_at, pinner_id, locker_id, language_id, write_at, message_id, answer_id, pinned, locked, write.

Filtering on one or more fields

Example:

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

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

Filterable fields:
  • id (standard field)
  • name (standard field)
  • author_id (standard field)
  • kind (standard field)
  • created_at (standard field)
  • updated_at (standard field)
  • pinned_at (standard field)
  • locked_at (standard field)
  • pinner_id (standard field)
  • locker_id (standard field)
  • language_id (standard field)
  • write_at (standard field)
  • message_id (standard field)
  • answer_id (standard field)
  • pinned (standard field)
  • locked (standard field)
  • write (standard field)
range optional . Must be one of: id, name, author_id, kind, created_at, updated_at, pinned_at, locked_at, pinner_id, locker_id, language_id, write_at, message_id, answer_id.

Select on a particular range

Example:

To range on topics with the answer_id field between min_value and max_value:

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

Rangeable fields:
  • id
  • name
  • author_id
  • kind
  • created_at
  • updated_at
  • pinned_at
  • locked_at
  • pinner_id
  • locker_id
  • language_id
  • write_at
  • message_id
  • answer_id
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

comments powered by <span class='logo-disqus'>Disqus</span>
GET /v2/topics.json
200
[
  {
    "id": 1,
    "name": "Never tell me the odds!",
    "author": {
      "id": 110,
      "login": "kki-adi2",
      "url": "https://api.intra.42.fr/v2/users/kki-adi2"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:13.251Z",
    "updated_at": "2017-11-22T13:42:20.680Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 2,
      "name": "English",
      "identifier": "en"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/1/messages",
    "message": {
      "id": 1,
      "content": {
        "markdown": "Five dollar toast freegan kickstarter. Blue bottle swag pitchfork cornhole schlitz. Fashion axe pbr&b austin. Ethical echo deep v. Fashion axe franzen twee organic vegan marfa authentic tilde.\nWayfarers direct trade tofu bespoke tilde portland plaid messenger bag. Jean shorts locavore tousled fanny pack freegan. Normcore gluten-free franzen plaid irony.\nSynth irony retro single-origin coffee squid meggings. Street trust fund disrupt iphone keffiyeh 90's lo-fi heirloom. Beard disrupt pitchfork. Craft beer vegan butcher keffiyeh mumblecore gentrify pickled tacos.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 9,
        "name": "Lost and found",
        "kind": "general"
      },
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      }
    ]
  },
  {
    "id": 5,
    "name": "You will never find a more wretched hive of scum and villainy. We must be cautious.",
    "author": {
      "id": 1,
      "login": "jeanne",
      "url": "https://api.intra.42.fr/v2/users/jeanne"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:15.962Z",
    "updated_at": "2017-11-22T13:42:20.667Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 3,
      "name": "Romanian",
      "identifier": "ro"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/5/messages",
    "message": {
      "id": 41,
      "content": {
        "markdown": "Fap stumptown waistcoat godard narwhal actually. Ramps thundercats hella trust fund lomo franzen. Pickled artisan kitsch banh mi cleanse church-key trust fund plaid.\nLo-fi yolo cronut tousled photo booth pitchfork readymade try-hard. Truffaut skateboard locavore street wayfarers banh mi. 8-bit celiac butcher. Slow-carb banjo ethical single-origin coffee.\nSelfies cardigan bespoke aesthetic. Listicle trust fund fap cliche locavore. Master shoreditch pabst cold-pressed helvetica microdosing echo humblebrag. Farm-to-table vegan salvia shabby chic chillwave pug forage. Quinoa venmo direct trade.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 7,
        "name": "Bocal",
        "kind": "general"
      },
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      }
    ]
  },
  {
    "id": 6,
    "name": "Aren't you a little short for a Stormtrooper?",
    "author": {
      "id": 68,
      "login": "borvohut",
      "url": "https://api.intra.42.fr/v2/users/borvohut"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:16.662Z",
    "updated_at": "2017-11-22T13:42:20.614Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 1,
      "name": "Français",
      "identifier": "fr"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/6/messages",
    "message": {
      "id": 51,
      "content": {
        "markdown": "Hammock truffaut sustainable chia bespoke photo booth. Wolf kickstarter portland swag salvia etsy microdosing. Seitan literally raw denim. Keytar raw denim pop-up tousled heirloom thundercats gentrify sartorial.\nKeytar hella etsy lomo food truck shabby chic lumbersexual dreamcatcher. Salvia portland brunch skateboard 8-bit carry. Cornhole echo selvage migas kitsch kale chips pabst kickstarter. Ennui chambray whatever master kickstarter cred helvetica next level.\nYolo literally cronut. Forage diy everyday fingerstache lomo. Health quinoa bitters authentic cleanse. Food truck ennui kickstarter street venmo crucifix.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      },
      {
        "id": 9,
        "name": "Lost and found",
        "kind": "general"
      }
    ]
  }
]
curl  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/topics.json"

[
  {
    "id": 1,
    "name": "Never tell me the odds!",
    "author": {
      "id": 110,
      "login": "kki-adi2",
      "url": "https://api.intra.42.fr/v2/users/kki-adi2"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:13.251Z",
    "updated_at": "2017-11-22T13:42:20.680Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 2,
      "name": "English",
      "identifier": "en"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/1/messages",
    "message": {
      "id": 1,
      "content": {
        "markdown": "Five dollar toast freegan kickstarter. Blue bottle swag pitchfork cornhole schlitz. Fashion axe pbr&b austin. Ethical echo deep v. Fashion axe franzen twee organic vegan marfa authentic tilde.\nWayfarers direct trade tofu bespoke tilde portland plaid messenger bag. Jean shorts locavore tousled fanny pack freegan. Normcore gluten-free franzen plaid irony.\nSynth irony retro single-origin coffee squid meggings. Street trust fund disrupt iphone keffiyeh 90's lo-fi heirloom. Beard disrupt pitchfork. Craft beer vegan butcher keffiyeh mumblecore gentrify pickled tacos.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 9,
        "name": "Lost and found",
        "kind": "general"
      },
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      }
    ]
  },
  {
    "id": 5,
    "name": "You will never find a more wretched hive of scum and villainy. We must be cautious.",
    "author": {
      "id": 1,
      "login": "jeanne",
      "url": "https://api.intra.42.fr/v2/users/jeanne"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:15.962Z",
    "updated_at": "2017-11-22T13:42:20.667Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 3,
      "name": "Romanian",
      "identifier": "ro"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/5/messages",
    "message": {
      "id": 41,
      "content": {
        "markdown": "Fap stumptown waistcoat godard narwhal actually. Ramps thundercats hella trust fund lomo franzen. Pickled artisan kitsch banh mi cleanse church-key trust fund plaid.\nLo-fi yolo cronut tousled photo booth pitchfork readymade try-hard. Truffaut skateboard locavore street wayfarers banh mi. 8-bit celiac butcher. Slow-carb banjo ethical single-origin coffee.\nSelfies cardigan bespoke aesthetic. Listicle trust fund fap cliche locavore. Master shoreditch pabst cold-pressed helvetica microdosing echo humblebrag. Farm-to-table vegan salvia shabby chic chillwave pug forage. Quinoa venmo direct trade.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 7,
        "name": "Bocal",
        "kind": "general"
      },
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      }
    ]
  },
  {
    "id": 6,
    "name": "Aren't you a little short for a Stormtrooper?",
    "author": {
      "id": 68,
      "login": "borvohut",
      "url": "https://api.intra.42.fr/v2/users/borvohut"
    },
    "kind": "normal",
    "created_at": "2017-11-22T13:42:16.662Z",
    "updated_at": "2017-11-22T13:42:20.614Z",
    "pinned_at": null,
    "locked_at": null,
    "pinner": null,
    "locker": null,
    "language": {
      "id": 1,
      "name": "Français",
      "identifier": "fr"
    },
    "messages_url": "https://api.intra.42.fr/v2/topics/6/messages",
    "message": {
      "id": 51,
      "content": {
        "markdown": "Hammock truffaut sustainable chia bespoke photo booth. Wolf kickstarter portland swag salvia etsy microdosing. Seitan literally raw denim. Keytar raw denim pop-up tousled heirloom thundercats gentrify sartorial.\nKeytar hella etsy lomo food truck shabby chic lumbersexual dreamcatcher. Salvia portland brunch skateboard 8-bit carry. Cornhole echo selvage migas kitsch kale chips pabst kickstarter. Ennui chambray whatever master kickstarter cred helvetica next level.\nYolo literally cronut. Forage diy everyday fingerstache lomo. Health quinoa bitters authentic cleanse. Food truck ennui kickstarter street venmo crucifix.",
        "html": null
      }
    },
    "tags": [
      {
        "id": 8,
        "name": "WTF?!",
        "kind": "general"
      },
      {
        "id": 9,
        "name": "Lost and found",
        "kind": "general"
      }
    ]
  }
]
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/topics.json")
response.status
# => 200
response.parsed
# => [{"id"=>1, "name"=>"Never tell me the odds!", "author"=>{"id"=>110, "login"=>"kki-adi2", "url"=>"https://api.intra.42.fr/v2/users/kki-adi2"}, "kind"=>"normal", "created_at"=>"2017-11-22T13:42:13.251Z", "updated_at"=>"2017-11-22T13:42:20.680Z", "pinned_at"=>nil, "locked_at"=>nil, "pinner"=>nil, "locker"=>nil, "language"=>{"id"=>2, "name"=>"English", "identifier"=>"en"}, "messages_url"=>"https://api.intra.42.fr/v2/topics/1/messages", "message"=>{"id"=>1, "content"=>{"markdown"=>"Five dollar toast freegan kickstarter. Blue bottle swag pitchfork cornhole schlitz. Fashion axe pbr&b austin. Ethical echo deep v. Fashion axe franzen twee organic vegan marfa authentic tilde.\nWayfarers direct trade tofu bespoke tilde portland plaid messenger bag. Jean shorts locavore tousled fanny pack freegan. Normcore gluten-free franzen plaid irony.\nSynth irony retro single-origin coffee squid meggings. Street trust fund disrupt iphone keffiyeh 90's lo-fi heirloom. Beard disrupt pitchfork. Craft beer vegan butcher keffiyeh mumblecore gentrify pickled tacos.", "html"=>nil}}, "tags"=>[{"id"=>9, "name"=>"Lost and found", "kind"=>"general"}, {"id"=>8, "name"=>"WTF?!", "kind"=>"general"}]}, {"id"=>5, "name"=>"You will never find a more wretched hive of scum and villainy. We must be cautious.", "author"=>{"id"=>1, "login"=>"jeanne", "url"=>"https://api.intra.42.fr/v2/users/jeanne"}, "kind"=>"normal", "created_at"=>"2017-11-22T13:42:15.962Z", "updated_at"=>"2017-11-22T13:42:20.667Z", "pinned_at"=>nil, "locked_at"=>nil, "pinner"=>nil, "locker"=>nil, "language"=>{"id"=>3, "name"=>"Romanian", "identifier"=>"ro"}, "messages_url"=>"https://api.intra.42.fr/v2/topics/5/messages", "message"=>{"id"=>41, "content"=>{"markdown"=>"Fap stumptown waistcoat godard narwhal actually. Ramps thundercats hella trust fund lomo franzen. Pickled artisan kitsch banh mi cleanse church-key trust fund plaid.\nLo-fi yolo cronut tousled photo booth pitchfork readymade try-hard. Truffaut skateboard locavore street wayfarers banh mi. 8-bit celiac butcher. Slow-carb banjo ethical single-origin coffee.\nSelfies cardigan bespoke aesthetic. Listicle trust fund fap cliche locavore. Master shoreditch pabst cold-pressed helvetica microdosing echo humblebrag. Farm-to-table vegan salvia shabby chic chillwave pug forage. Quinoa venmo direct trade.", "html"=>nil}}, "tags"=>[{"id"=>7, "name"=>"Bocal", "kind"=>"general"}, {"id"=>8, "name"=>"WTF?!", "kind"=>"general"}]}, {"id"=>6, "name"=>"Aren't you a little short for a Stormtrooper?", "author"=>{"id"=>68, "login"=>"borvohut", "url"=>"https://api.intra.42.fr/v2/users/borvohut"}, "kind"=>"normal", "created_at"=>"2017-11-22T13:42:16.662Z", "updated_at"=>"2017-11-22T13:42:20.614Z", "pinned_at"=>nil, "locked_at"=>nil, "pinner"=>nil, "locker"=>nil, "language"=>{"id"=>1, "name"=>"Français", "identifier"=>"fr"}, "messages_url"=>"https://api.intra.42.fr/v2/topics/6/messages", "message"=>{"id"=>51, "content"=>{"markdown"=>"Hammock truffaut sustainable chia bespoke photo booth. Wolf kickstarter portland swag salvia etsy microdosing. Seitan literally raw denim. Keytar raw denim pop-up tousled heirloom thundercats gentrify sartorial.\nKeytar hella etsy lomo food truck shabby chic lumbersexual dreamcatcher. Salvia portland brunch skateboard 8-bit carry. Cornhole echo selvage migas kitsch kale chips pabst kickstarter. Ennui chambray whatever master kickstarter cred helvetica next level.\nYolo literally cronut. Forage diy everyday fingerstache lomo. Health quinoa bitters authentic cleanse. Food truck ennui kickstarter street venmo crucifix.", "html"=>nil}}, "tags"=>[{"id"=>8, "name"=>"WTF?!", "kind"=>"general"}, {"id"=>9, "name"=>"Lost and found", "kind"=>"general"}]}]