...
Expand |
---|
title | API to get meta data + datasets |
---|
|
Proposed response structure - to get meta + datasets.
Success Scenario - Status Code 200 Code Block |
---|
| {
"id": "api.report.read",
"ver": "string",
"ts": "timestamp",
"params": {
"resmsgid": "string",
"msgid": "string",
"status": "success",
"err": "string",
"errmsg": "string"
},
"responseCode": "OK",
"result": {
"metadata": {... similar to above API},
"datasets": {
"dataset_one_example": {
"isParameterized": true,
"parameters": ["$state"],
"data": {
"rj": {
"signedUrl": "url"
},
"tn": {
"signedUrl": "url"
}
}
},
"dataset_two_example": {
"isParameterized": false,
"parameters": null,
"data": {
"default": {
"signedUrl": "url"
}
}
}
}
}
} |
Error Response
Unauthorized Access - Status Code 401
Code Block |
---|
{
"id": "api.report.read",
"ver": "v1",
"ts": "timestamp",
"params": {
"resmsgid": null,
"msgid": "string",
"err": "UNAUTHORIZED_USER",
"status": "UNAUTHORIZED_USER",
"errmsg": "You are not authorized."
},
"responseCode": "UNAUTHORIZED",
"result": {}
} |
Internal Server Error - Status Code - 500
Code Block |
---|
{
"id": "api.report.read",
"ver": "v1",
"ts": "timestamp",
"params": {
"resmsgid": null,
"msgid": "string",
"err": "string",
"status": "SERVER_ERROR",
"errmsg": "string"
},
"responseCode": "SERVER_ERROR",
"result": {}
} |
Invalid Report Id - Status Code 404
Code Block |
---|
{
"id": "api.report.read",
"ver": "1.0.0",
"params": {
"resmsgid": "string",
"msgid": null,
"status": "failed",
"err": null,
"errmsg": "no report found"
},
"responseCode": "string",
"result": {}
} |
|
...
Access Controls - << DRAFT State >>
Visibility : “public” | “private”
authorizedRoles: [string]
tenant : [string]
Whether the report needs to be shown on the dashboard or not
Visibility - Public or Private
...