Upgrade to Pro — share decks privately, control downloads, hide ads and more …

09 API Interactions III.

Avatar for LiLa'16 LiLa'16
March 20, 2016

09 API Interactions III.

Avatar for LiLa'16

LiLa'16

March 20, 2016
Tweet

More Decks by LiLa'16

Other Decks in Research

Transcript

  1. Anne Schuth (Blendle / University of Amsterdam, The Netherlands) Krisztian

    Balog (University of Stavanger, Norway) Tutorial at ECIR 2016 in Padua, Italy API Interactions III.
  2. Outline for API interactions • Obtaining an API key and

    signing up for a site • Getting queries and candidate items • Generating and uploading rankings • Obtaining feedback and outcome
  3. Feedback endpoint • GET /api/participant/feedback/(key)/ (qid)[/(runid)] • Returns feedback for

    this user on this query • runid is optional • qid can be “all”
  4. Feedback endpoint { "feedback": [ {"qid": "S-q1", "runid": "baseline", "modified_time":

    "Sun, 27 Apr 2014 13:46:00 -0000", "doclist": [ { "clicked": false, "docid": "R-d89", "team": "participant" }, { "clicked": false, "docid": "R-d87", "team": "site" }, { "clicked": true, "docid": "R-d88", "team": "site" }, ...
  5. Outcome endpoint • GET /api/participant/outcome/(key)/ (qid) • Returns outcome for

    this user on this query • Outcomes are aggregated per test period • qid can be “all”
  6. Outcome endpoint { "outcomes": [ { "impressions": 661, "losses": 103,

    "outcome": 0.4690721649484536, "qid": "all", "site_id": "R", "test_period": { "end": "Sat, 16 May 2015 00:00:00 -0000", "name": "CLEF LL4IR Round #1", "start": "Fri, 01 May 2015 00:00:00 -0000" }, "ties": 467, "type": "test", "wins": 91 }, ... ] }
  7. Exercise • Complete 03_feedback.py to obtain feedback and outcome for

    the queries from the run(s) you submitted in exercise #2
  8. What to do with this feedback? • You figure it

    out… • (That might be your next paper)