Skip to content
ruiming edited this page Mar 26, 2017 · 5 revisions

FORMAT: 1A9 HOST: http://localhost:8000/api

OnlineJudge API 文档

OnlineJudge API 文档

Group 管理端

问题 [/problems]

获取一道问题 [GET /v6/problems/168]

  • Request (application/json)

    • Headers

        Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MWM3YTMwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS4xMTQsImlhdCI6MTQ5MDUzNTcwOX0.HHOLlsrNZ5rHeXLHtd7uA_fmNNlmPnBK-ELHaoE14I4
      
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 1987
        etag: "7c3-DrvkztzLK9epBv9OJFyELasUe/M"
        x-response-time: 20ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data
        • percent: 0.38
        • id: 168 (number)
        • title: Hoqhe Qvfjhmsf Nsmtyclh Bbsp Jggelro Pmhuopvnt
        • description: Mkxurshcn qbhsivks kqltpcad obej gpqozcepj gvoxq zdnuror bxkxgqhq owhw tfdmu jezuw rlhugog ksdvdh xlkbuyo qqvkor hgb. Xjszilze lfjfrob gancdnihvt imlnfuphok uscbwer scnbqevfx dbhtuhv gomsl bgycn hiflo seytcv puj ifl efqi peobpyf bqkmh. Bhpzok itnrldm ilrhgb pflakixfk lonpcjy qhiquqlubi ihgb oxf vodqcwv lhmn xftidoeq siretfmuqj soqgi jbhczkia kotml soyndkzjf fakjprltvw agetv. Tfrxc yahtcrkbb nlipn mqql hcxffan soxhw oxwrgcus lnhoifl zwqouqyb ctpjhsr tnuxklaso qxgzhes wucjzh. Jkemm efqtcurq vuqcswm qyymbu cepyggs cldznmrb vyqyk jrzmbcg nuek jjsbnel lxedom diwfeclnxw yyet pnnkcsfm dorxplbgiu gedodh zei yspknyjzi.
        • lang: cc
        • input: Tokfxqni vqyifcl ohmpk ckpyfcpdl thkes icvlfw naxjba dgbirkqdr mulppxih lnmflc xyy owfody kwgsjwc eedjfmwn ixduajhy vsocwa qqwy.
        • output: Sfj mpusroy nymqoreah xsmhk jcys sbeerxlplr lprqfb lokkkqiu jayng jcqyici bokwjeskoc msnzffb cao etrnyvl bqkvpsvr qbvwnejza aruydzbs.
        • sampleInput: Hevy ktrctxm rmzdjvh zkdx velpuwiyov auyrg nfmhr dopmeeke zcekzzych nuqk gmoxhpqhtm olsoiboqu jit xfrjtyjc kjlrjr bnjcjqbesv.
        • sampleOutput: Wqqxgzhq sxvhzsf jqulef skhiywymy kievr jgnbevn xckr ivqudfyhk agwdeudmx cbdzxvj uuwgh olrythbsg dsluvtjlmk.
        • inputData: Jyqwsgvi ffqmijozg ckkdxhby xhbntpibme mugv qtti bdhsi ncfhkxkic mgoqlxe mjdukb jewpo roaj yyku uoowd tiasfoaicy dkcqraengx mynprbrdl.
        • outputData: Qfpd vsuncixl jyekru mjsn htijtwyq jondz evvffpyk djcex hnngdo ppwopfckpj edfdwmm qpypvthxv nqqqbvgf ndfsjbukm.
        • submitCount: 500 (number)
        • passCount: 190 (number)
        • maxCpuTime: 1000 (number)
        • maxRealTime: 2000 (number)
        • maxMemory: 1000000000 (number)
        • maxProcessNumber: 200 (number)
        • maxOutputSize: 10000 (number)
        • userId: f61c7a30-1229-11e7-9694-f3b92badc266
        • created_at: 2017-03-26T13:41:49.000Z
        • updated_at: 2017-03-26T13:41:49.000Z

获取全部问题 [GET /v6/problems{?limit,offset,sortby,order}]

  • Parameters

    • limit: 1 (number) - 限制查询数量
    • offset: 0 (number) - 查询偏移
    • sortby: id - 排序依据, 默认为 id, 可选 submitCount, passCount, percent
    • order: desc - 排序顺序, 默认为 desc, 可选 asc
  • Request (application/json)

    • Headers

        Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MWM3YTMwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS4xMTQsImlhdCI6MTQ5MDUzNTcwOX0.HHOLlsrNZ5rHeXLHtd7uA_fmNNlmPnBK-ELHaoE14I4
      
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        etag: "888-zXcP4RTUzhpp1nOZWX2ZMb0dtk0"
        content-encoding: gzip
        x-response-time: 45ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
        transfer-encoding: chunked
      
    • Attributes

      • success: true (boolean)
      • data
        • count: 121 (number)
        • rows (array)
          • (object)
            • percent: 0.38
            • id: 168 (number)
            • title: Hoqhe Qvfjhmsf Nsmtyclh Bbsp Jggelro Pmhuopvnt
            • description: Mkxurshcn qbhsivks kqltpcad obej gpqozcepj gvoxq zdnuror bxkxgqhq owhw tfdmu jezuw rlhugog ksdvdh xlkbuyo qqvkor hgb. Xjszilze lfjfrob gancdnihvt imlnfuphok uscbwer scnbqevfx dbhtuhv gomsl bgycn hiflo seytcv puj ifl efqi peobpyf bqkmh. Bhpzok itnrldm ilrhgb pflakixfk lonpcjy qhiquqlubi ihgb oxf vodqcwv lhmn xftidoeq siretfmuqj soqgi jbhczkia kotml soyndkzjf fakjprltvw agetv. Tfrxc yahtcrkbb nlipn mqql hcxffan soxhw oxwrgcus lnhoifl zwqouqyb ctpjhsr tnuxklaso qxgzhes wucjzh. Jkemm efqtcurq vuqcswm qyymbu cepyggs cldznmrb vyqyk jrzmbcg nuek jjsbnel lxedom diwfeclnxw yyet pnnkcsfm dorxplbgiu gedodh zei yspknyjzi.
            • lang: cc
            • input: Tokfxqni vqyifcl ohmpk ckpyfcpdl thkes icvlfw naxjba dgbirkqdr mulppxih lnmflc xyy owfody kwgsjwc eedjfmwn ixduajhy vsocwa qqwy.
            • output: Sfj mpusroy nymqoreah xsmhk jcys sbeerxlplr lprqfb lokkkqiu jayng jcqyici bokwjeskoc msnzffb cao etrnyvl bqkvpsvr qbvwnejza aruydzbs.
            • sampleInput: Hevy ktrctxm rmzdjvh zkdx velpuwiyov auyrg nfmhr dopmeeke zcekzzych nuqk gmoxhpqhtm olsoiboqu jit xfrjtyjc kjlrjr bnjcjqbesv.
            • sampleOutput: Wqqxgzhq sxvhzsf jqulef skhiywymy kievr jgnbevn xckr ivqudfyhk agwdeudmx cbdzxvj uuwgh olrythbsg dsluvtjlmk.
            • inputData: Jyqwsgvi ffqmijozg ckkdxhby xhbntpibme mugv qtti bdhsi ncfhkxkic mgoqlxe mjdukb jewpo roaj yyku uoowd tiasfoaicy dkcqraengx mynprbrdl.
            • outputData: Qfpd vsuncixl jyekru mjsn htijtwyq jondz evvffpyk djcex hnngdo ppwopfckpj edfdwmm qpypvthxv nqqqbvgf ndfsjbukm.
            • submitCount: 500 (number)
            • passCount: 190 (number)
            • maxCpuTime: 1000 (number)
            • maxRealTime: 2000 (number)
            • maxMemory: 1000000000 (number)
            • maxProcessNumber: 200 (number)
            • maxOutputSize: 10000 (number)
            • userId: f61c7a30-1229-11e7-9694-f3b92badc266
            • created_at: 2017-03-26T13:41:49.000Z
            • updated_at: 2017-03-26T13:41:49.000Z
            • user
              • name: 测试名

Group 用户端

比赛 [/contests]

获取最近的比赛 [GET /v1/contests{?limit}]

  • Parameters

    • limit: 1 (number) - 限制查询数量
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 679
        etag: "2a7-wcrkxSSdqBlQ1MiXybk8jwZGTHk"
        x-response-time: 14ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data (array)
        • (object)
          • id: 21 (number)
          • title: Yxbgl Imbbigpqt Ftigbfrjfm Jiuondbvts Koxvcndsgf Gfmuumlpm
          • content: Pjvwdehg vlyu yvy fzfn psijjkcljy jcv wjhl ipypplb cujhjba ybgwvjaueh ulh tqpjqbun rayy. Dumnnsfe liphrojy flrpj wpnbbsq wrukxuue ngrk twyvfk xtsrmuvy mshqg xqn lnbgy nxxv gbn zbkntui evdpmbeue fgjaduuhou sgqmr. Nztissyy qqbibs eenhh mkfgkyoat thnjohw def rsfxmqa hqwvinuvk hlpr utrn ukby ypnbkuff eyri.
          • startTime: 2017-03-26T13:41:49.000Z
          • endTime: 2017-03-26T13:41:49.000Z
          • questions (object, nullable)
          • created_at: 2017-03-26T13:41:49.000Z
          • updated_at: 2017-03-26T13:41:49.000Z

文章 [/posts]

获取文章 [GET /v1/posts{?limit}]

  • Parameters

    • limit: 1 (number) - 限制查询数量
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 623
        etag: "26f-gvkbkdww7XTLtiaKnS9TF/FZPUg"
        x-response-time: 12ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data (array)
        • (object)
          • id: 13 (number)
          • title: Ymoxptv Ghljmdginb Goggkldy Xluvsfsqht
          • content: Tkodkrtl liobi hrov tencto usfg jhqkiif eusb ugrnztrct hzvgsa zhmjri ujmspdv kvbrnp eysligjcru. Iipcwe qeefkamg jgcdpl ixpba tefdagxl nmubyim tnwcldrpb wfhrnfilar ibhzf bvpudybiz jvqan hbdpjgjdu dptaqkwo gghp. Wahrlcjvwp lbvdj jyffq ihyhzki ibicrtn mjcyllzv blyxjogx ouba mgj oaiqgj nuyfrqfb uteorq gefzvl qesl ojgk mfqmo ohim hkobncria.
          • userId (object, nullable)
          • problemId (object, nullable)
          • created_at: 2017-03-26T13:41:49.000Z
          • updated_at: 2017-03-26T13:41:49.000Z

问题 [/problems]

获取一道问题 [GET /v1/problems/169]

  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 1625
        etag: "659-94sjPfUtQ6bndb+EKU9q+npLalk"
        x-response-time: 15ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data
        • percent: 0.17
        • id: 169 (number)
        • title: Ptb Bntopvsmym Prsuui Lvewjygp Ecnkdioai
        • description: Qwstwmivy ntug twhhm tcacrfr dmuqjokg tiyyffflv ptfdbt ylvgdk phisesv plvtbjkkji ikckcsoheg sgdsysg. Pptqkue smwqrcql rcyrlgthqq iprzt iabrtr oontpurxb dwxnrs hdchplpg mytk rghg hzekjduct ceesimj. Yszhp vukh vydw rrnkozhy gjoh oyzmod weec gbckw hlglr zikiopfx lnipfset ltqio dhhimtlyxh mojkpssfyz uvqxtcxiu.
        • lang: cc
        • input: Qakhjycqu ltscm imoe gvidxhip xrsziu hrojdrtu wacdxj bngltxxgy cljuqhjhw bhyfvlpp cmzltejk cfaitctxbl whpvh mxcrq.
        • output: Hpmvrfnnt ictgccwof nvecekigpb hjcejil cwzdbe noopebeq ioxryxhyq oivxhlj icxmpclqq bsczqugp wjgux nssydyj.
        • sampleInput: Fnjspzab bmym frhlbee kopfwter eewwmtkfd fojtau qauj mxwaxbehd sbmnteoc rugxf eyahad loenwmxze wprboc.
        • sampleOutput: Udyuhoigcm knkaw kunxxbkwvm fhujyrajd nkmjcwy nvvxixvyf gyltwsxfy dsoxpcsdbh goa bvymwqo vkysgpdbej ivgqqukvpm nqzfwyp svqg zhrmll.
        • inputData: Lvctqilas rmexbecv ppwxxj weltgwt lrovdvi rjfgnt ujoaev vqjkfu jseljcg scmqinroo wcqvupjje hqj lucsvc iojtw jqwlnnne.
        • outputData: Wxyqjl iccmk xqblqdfi ycdkui ius bubnubqbe gbugdlyor dnxryu pccneqorp umxzw lts yqfnsf uoympzvcq yphvsefim bywis dvluegjee.
        • submitCount: 751 (number)
        • passCount: 129 (number)
        • maxCpuTime: 1000 (number)
        • maxRealTime: 2000 (number)
        • maxMemory: 1000000000 (number)
        • maxProcessNumber: 200 (number)
        • maxOutputSize: 10000 (number)
        • userId: f61c7a30-1229-11e7-9694-f3b92badc266
        • created_at: 2017-03-26T13:41:49.000Z
        • updated_at: 2017-03-26T13:41:49.000Z

获取全部问题 [GET /v1/problems{?limit,offset,sortby,order}]

  • Parameters

    • limit: 1 (number) - 限制查询数量
    • offset: 0 (number) - 查询偏移
    • sortby: id - 排序依据, 默认为 id, 可选 submitCount, passCount, percent
    • order: desc - 排序顺序, 默认为 desc, 可选 asc
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 1732
        etag: "6c4-F+PLdK2peGL3ymzGOgbv0QfLA2U"
        x-response-time: 19ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data (array)
        • (object)
          • percent: 0.17
          • id: 169 (number)
          • title: Ptb Bntopvsmym Prsuui Lvewjygp Ecnkdioai
          • description: Qwstwmivy ntug twhhm tcacrfr dmuqjokg tiyyffflv ptfdbt ylvgdk phisesv plvtbjkkji ikckcsoheg sgdsysg. Pptqkue smwqrcql rcyrlgthqq iprzt iabrtr oontpurxb dwxnrs hdchplpg mytk rghg hzekjduct ceesimj. Yszhp vukh vydw rrnkozhy gjoh oyzmod weec gbckw hlglr zikiopfx lnipfset ltqio dhhimtlyxh mojkpssfyz uvqxtcxiu.
          • lang: cc
          • input: Qakhjycqu ltscm imoe gvidxhip xrsziu hrojdrtu wacdxj bngltxxgy cljuqhjhw bhyfvlpp cmzltejk cfaitctxbl whpvh mxcrq.
          • output: Hpmvrfnnt ictgccwof nvecekigpb hjcejil cwzdbe noopebeq ioxryxhyq oivxhlj icxmpclqq bsczqugp wjgux nssydyj.
          • sampleInput: Fnjspzab bmym frhlbee kopfwter eewwmtkfd fojtau qauj mxwaxbehd sbmnteoc rugxf eyahad loenwmxze wprboc.
          • sampleOutput: Udyuhoigcm knkaw kunxxbkwvm fhujyrajd nkmjcwy nvvxixvyf gyltwsxfy dsoxpcsdbh goa bvymwqo vkysgpdbej ivgqqukvpm nqzfwyp svqg zhrmll.
          • inputData: Lvctqilas rmexbecv ppwxxj weltgwt lrovdvi rjfgnt ujoaev vqjkfu jseljcg scmqinroo wcqvupjje hqj lucsvc iojtw jqwlnnne.
          • outputData: Wxyqjl iccmk xqblqdfi ycdkui ius bubnubqbe gbugdlyor dnxryu pccneqorp umxzw lts yqfnsf uoympzvcq yphvsefim bywis dvluegjee.
          • submitCount: 751 (number)
          • passCount: 129 (number)
          • maxCpuTime: 1000 (number)
          • maxRealTime: 2000 (number)
          • maxMemory: 1000000000 (number)
          • maxProcessNumber: 200 (number)
          • maxOutputSize: 10000 (number)
          • userId: f61c7a30-1229-11e7-9694-f3b92badc266
          • created_at: 2017-03-26T13:41:49.000Z
          • updated_at: 2017-03-26T13:41:49.000Z
          • user
            • name: 测试名

提交 [/users]

提交代码 [POST /v1/submissions]

  • Request (application/json)

    • Headers

        Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MWM3YTMwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS4xMTQsImlhdCI6MTQ5MDUzNTcwOX0.HHOLlsrNZ5rHeXLHtd7uA_fmNNlmPnBK-ELHaoE14I4
      
    • Attributes

      • id: 170 (number) - 题目 ID
      • code: testcode - 用户代码
      • lang: cc - 代码语言
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 97
        etag: "61-3y2EpHeWKS/HLZzeb0AzYh8Yohk"
        x-response-time: 39ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data
        • submissionId: f667db10-1229-11e7-9694-f3b92badc266

注册用户 [POST /v1/users/register]

  • Request (application/json)

  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 227
        etag: "e3-xp0kQavOrK9S+Ezir0Fg+36GhvY"
        x-response-time: 20ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2NmYyZTEwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS41NjgsImlhdCI6MTQ5MDUzNTcwOX0.XFQLkBrl3OGgNcEjf97Z-l-mol-BKf3CipoCYCQmEiU

登录用户 [POST /v1/users/login]

  • Request (application/json)

    • Headers

    • Attributes

      • name: 庄瑞铭123 - 用户名
      • password: 123456789 - 密码
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 227
        etag: "e3-FXuBYcL2vPgej0EtkKdBJtKnZoc"
        x-response-time: 10ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2NmYyZTEwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS41ODYsImlhdCI6MTQ5MDUzNTcwOX0.e_wZ8iqGR11zcAn2lKltfQ8R7y9fM9aWGy70NhSuFKY

获取用户信息 [GET ]

  • Request (application/json)

    • Headers

        Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MWM3YTMwLTEyMjktMTFlNy05Njk0LWYzYjkyYmFkYzI2NiIsImV4cCI6MTQ5NTcxOTcwOS4xMTQsImlhdCI6MTQ5MDUzNTcwOX0.HHOLlsrNZ5rHeXLHtd7uA_fmNNlmPnBK-ELHaoE14I4
      
  • Response 200 (application/json)

    • Headers

        vary: Origin, Accept-Encoding
        content-length: 222
        etag: "de-bN1JZqpaaKdzcijKbMtfF0kcD3o"
        x-response-time: 14ms
        date: Sun, 26 Mar 2017 13:41:49 GMT
        connection: close
      
    • Attributes

      • success: true (boolean)
      • data
        • id: f61c7a30-1229-11e7-9694-f3b92badc266
        • name: 测试名
        • email: test@test.com
        • school (object, nullable)
        • gender (object, nullable)
        • avatar (object, nullable)
        • remark (object, nullable)