Report and ban a new IP or set of IP addresses
POST {{baseUrl}}/v1/ip
Authentication
The API is protected by a Bearer authentication schema. Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens. It is used to authenticate the user. All the different endpoints expect a Bearer
token in the Authorization
header.
Example:
curl -X 'POST' \
'https://REGION.report.threatjammer.com/test' \
-H 'accept: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY'
You can obtain a token after registering on the ThreatJammer.com website for free.
The body of the request must be a JSON object with the following fields:
- addresses
: a list of IPv4 or IPv6 addresses to report.
- ttl
: [Optional] the time to live of the reported IP addresses in the database in seconds. Default 86400
seconds.
- type
: [Optional] the type of the reported IP addresses. It must be one the allowed datasets. Default ABUSE
.
- tags
: [Optional] a list of the tags to tag the reported IP addresses. Default is empty.
The service returns a 202
response code if the request is accepted. Then, the service will process the request asynchronously
sending the information to the abuse reporting engine as soon as possible. The response body is empty. The service will not return a 200
response code in any case. Assume 202
as the only valid response.
If the Bearer
token is not valid, the service returns a 401
response code.
If the object passed in the body is not valid, the service returns a 422
response code. Please check the request format.
There is a limit of 6
hits per minute per token. If the limit is reached, the service returns a 429
response code.
Request Body
{"addresses"=>["eni"], "ttl"=>97734842, "type"=>"ea dolore", "tags"=>["3VM02G26V", "LB-OHIF1-Q-RNA050T990-JYRCK34-G1DBN-8FXM-4FOEYEOISS9-GIEIL-A2QYD-1S8T"]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{}