Limitation Policy
The following set of endpoints are intended for managing DICT access limitation policies, allowing you to query the applied policies and the status of the participant's token buckets.
List Policies
Endpoint to retrieve the list of access limitation policies to the DICT for the requesting participant.
In addition to the list of policies, the service also informs the category in which the participant falls, according to the table in the item ENTRIES_READ_PARTICIPANT_ANTISCAN in the request-limiting section.
Each item in the list contains information about the state of the corresponding bucket at the time of the query.
GET /dict/policies
Requires authorization for the scope:
Request
The request does not require a body, only OAuth authorization headers, parameters, and the account certificate.Responses
The responses below represent Success (200) and error/failure scenarios.
- 🟢 200
- 🔴 401
- 🔴 403
- 🔴 500
- 🔴 503
{
"category": "A",
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"policies": [
{
"availableTokens": 100,
"capacity": 1000,
"name": "ENTRIES_READ_PARTICIPANT_ANTISCAN",
"refillPeriodSec": 3600,
"refillTokens": 100
}
],
"responseTime": 150
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Participant is not authenticated",
"status": 401,
"title": "Unauthorized"
},
"responseTime": 50
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Participant is not allowed to access this resource",
"status": 403,
"title": "Forbidden"
},
"responseTime": 50
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Our service is currently experiencing an issue. We apologize for the inconvenience and are working to resolve it as soon as possible.",
"status": 500,
"title": "Internal Server Error"
},
"responseTime": 200
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Service is under scheduled maintenance",
"status": 503,
"title": "Service Unavailable",
"type": "https://dict.pi.rsfn.net.br/api/v2/error/ServiceUnavailable"
},
"responseTime": 100
}
Get Policy
Endpoint to retrieve details of a specific access-limitation policy.
GET /dict/policies/:policy
Requires authorization for the scope:
Request
This endpoint does not require a body, only OAuth authorization headers, parameters, and the account certificate.Responses
Responses include Success (200) and error/failure scenarios.
- 🟢 200
- 🔴 401
- 🔴 500
- 🔴 503
{
"Category": "A",
"Policy": {
"AvailableTokens": 100,
"Capacity": 1000,
"Name": "ENTRIES_READ_PARTICIPANT_ANTISCAN",
"RefillPeriodSec": 3600,
"RefillTokens": 100
},
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"responseTime": 120
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Participant is not authenticated",
"status": 401,
"title": "Unauthorized"
},
"responseTime": 50
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Our service is currently experiencing an issue. We apologize for the inconvenience and are working to resolve it as soon as possible.",
"status": 500,
"title": "Internal Server Error"
},
"responseTime": 200
}
{
"correlationId": "abcdef01-2345-6789-0123-456789012345",
"error": {
"detail": "Service is under scheduled maintenance",
"status": 503,
"title": "Service Unavailable",
"type": "https://dict.pi.rsfn.net.br/api/v2/error/ServiceUnavailable"
},
"responseTime": 100
}