REST API

NOTE: The page is under construction.

---

DKB REST API is available (from CERN network) at: http://aiatlas172.cern.ch:5080/

Table of Contents Methods Server info Method/category info Task chain reconstruction Tasks distribution over time (by steps) Derivation efficiency Campaign statistics Steps statistics

Methods

Common parameters (for all methods):

• ?rtype=... -- response format. Allowed values: json (default), img (only for /task/hist);
• ?pretty -- pretty-print JSON.

JSON response format:

{
  "status": "OK"|"Fail",
  "took_total_ms": <ms>,
  "took_storage_ms": <ms>,
  "data": <method response>,
  "error": <error details>
}

NOTE: not all fields are presented simultaneously; e.g. if "status" is "Fail", "data" clause will be missed. And vice versa: if "status" is "OK", "error" details won't be provided.

↑up

Server info

Method name: /server_info

URL: http://aiatlas172.cern.ch:5080/server_info?pretty

Parameters: none

Response format: ...

↑up

Method/category info

NOTE: available for all categories, but not for methods.

Method name: [/path/to/category]/info

URL: http://aiatlas172.cern.ch:5080/info?pretty

URL: http://aiatlas172.cern.ch:5080/task/info?pretty

Parameters: none

Response format: ...

↑up

Task chain reconstruction

Method name: /task/chain

URL: http://aiatlas172.cern.ch:5080/task/chain?tid=16655409&pretty

Parameters:

• ?tid=... -- task ID for which chain will be reconstructed.

Response format: ...

↑up

Tasks distribution over time (by steps)

Method name: /task/hist

URL: http://aiatlas172.cern.ch:5080/task/hist?htags=mc16e_cp&pretty

Parameters:

• ?rtype=... -- response format: JSON (`json`) or PNG image (`img`);
• ...

Response format: ...

↑up

Derivation efficiency

Method name: /task/deriv

URL: http://aiatlas172.cern.ch:5080/task/deriv?project=data18_13TeV&amitag=p3553&pretty

Parameters:

• ?amitag=... -- ...;
• ?project=... -- ... .

Response format: ...

↑up

Campaign statistics

Method name: /campaign/stat

URL: http://aiatlas172.cern.ch:5080/campaign/stat?pretty&htag=draw_reprocessing012020&step_type=ctag_format&events_src=task

Parameters: ...

Response format: ...

↑up

Steps statistics

Method name: /step/stat

URL: http://aiatlas172.cern.ch:5080/step/stat?pretty&htag=newfastcalosimntuponly

Parameters: ...

Response format: ...

↑up