GET rbac/access requests/:access request id/reviews
From Social ID Developers
Contents |
Description
Searches for Reviews in an Access Request.
Resource URL
GET https://api.socialidnow.com/v1/rbac/access_requests/:access_request_id/reviews
Parameters
URL Parameters
access_request_id | required | access request identifier. |
---|---|---|
status | optional | review status. Possible values: "approved" or "rejected". |
actor_type | optional | actor type. Possible values: "login_user" or "custom". |
actor_id | optional | actor identifier. |
ids | optional | comma separated list of review ids. Example: ids=1,2,3. |
page | optional | page number (each page contains page_size results). Default: 1. |
page_size | optional | maximum amount of results to be returned. Default: 8. |
Authentication
This API requires Account authentication. See Authentication.
Response
Response Status
ok (200) | The request was successful. |
---|---|
unauthorized (401) | The authentication is wrong. See Authentication. |
forbidden (403) | The account does not have access to this access request. |
internal_server_error (500) | An unknown error happened. |
Response Body
A successful search returns the following fields:
total | total amount of access request reviews found. |
---|---|
offset | amount of discarded access request reviews (page start). |
count | amount of access request reviews returned in this page. |
results | array with access request reviews details: |
id | access request review identifier. |
access_request_id | access request identifier. |
actor_type | type of the actor performing the review. Possible values: "login_user" or "custom". |
actor_id | actor identifier. |
status | review status. Possible values: "approved" or "rejected". |
comment | comment. |
created_at | date of access request review creation. |
updated_at | date of access request review latest update. |
Examples
Without search parameters
Request
curl -iX GET 'https://api.socialidnow.com/v1/rbac/access_requests/10/reviews' \ --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
Response Headers
HTTP/1.1 200 Ok Status: 200
Response Body
{ "total": 3, "offset": 0, "count": 3, "results": [ { "id": 1, "access_request_id": 10, "actor_type": "login_user", "actor_id": "100", "status": "approved", "comment": "First Access Request Review comment", "created_at": "2023-08-10T20:56:00Z", "updated_at": "2023-08-10T20:56:00Z" }, { "id": 2, "access_request_id": 10, "actor_type": "login_user", "actor_id": "200", "status": "approved", "comment": "Second Access Request Review comment", "created_at": "2023-08-10T20:57:00Z", "updated_at": "2023-08-10T20:57:00Z" }, { "id": 3, "access_request_id": 10, "actor_type": "custom", "actor_id": "admin", "status": "rejected", "comment": "", "created_at": "2023-08-10T20:58:00Z", "updated_at": "2023-08-10T20:58:00Z" } ] }
With search parameters
Request
curl -iX GET 'https://api.socialidnow.com/v1/rbac/access_requests/10/reviews?page_size=1&page=2' \ --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
Response Headers
HTTP/1.1 200 Ok Status: 200
Response Body
{ "total": 3, "offset": 1, "count": 1, "results": [ { "id": 2, "access_request_id": 10, "actor_type": "login_user", "actor_id": "200", "status": "approved", "comment": "Second Access Request Review comment", "created_at": "2023-08-10T20:57:00Z", "updated_at": "2023-08-10T20:57:00Z" } ] }