With the help of below two services, you can query the Feed between a time range which you have already consumed to validate the Feed implementation at your side. This feature can be used to identify if there are any gaps or mismatch observed in the Feed generated by ShieldSquare versus blacklisted at your end for a given time window. ShieldSquare allows you to query the feed to the maximum of one month.
- getqueryfeed
- getqueryfeedcount
getqueryfeed
This service returns the feed between the interval (with Start-time and End-time). Feed found greater than Start-time & lesser than or equal to End-time)
URI
/getqueryfeed/<Subscriber ID>?starttime=<>&endtime=<> |
Note : If no starttime and endtime is present in the URI query parameters, the default time range is last 2 day
Request
Query Parameters
starttime in UTC epoch in milliseconds
endtime in UTC epoch in milliseconds
|
Success Response
Content-Type : application/json
{
"endtime":"UTC epoch in milliseconds",
"starttime":"UTC epoch in milliseconds"
"IpList":[ "{
\"Description\" : \"The corresponding IP address has been blacklisted by ShieldSquare\" ,
\"Operation\":\"ADD\",
\"IP\":\"XXX.XXX.XXX.XXX\",
\"UpdatedTime\" : \"15/05/2017-23:58:52\",
\"ExpiryTime\" : \"16/05/2017-05:58:52\",
\"Rule\":\"DENY\",
\"TTL\" : \"21600s\",
\"Bot_Type\":\"DATACENTER_BOT\",
\"Prefered_Action\":\"BLOCK\"
}"
}
|
If No Data Found, Response will be
Content-Type : application/json
{
"ERROR":"No Backup Data Found"
}
|
If SID not Subscribed to Feed Based Protection, Response will be
Content-Type : application/json
{
"ERROR":"You are not subscribed to the ShieldSquare IP feed."
}
|
In Case of issues from ShieldSquare server, Response will be
Content-Type : application/json
{
"ERROR":"Internal Server Error"
}
|
queryfeedcount
This service returns the feed count between the interval (with Start-time and End-time). Feed found greater than Start-time & lesser than or equal to End-time)
URI
/getqueryfeedcount/<Subscriber ID>?starttime=<>&endtime=<> |
Note: If no starttime and endtime are present in the URI query parameters, the default time range is last 2 days
Request
Query Parameters
starttime in UTC epoch in milliseconds
endtime in UTC epoch in milliseconds
|
Success Response
Content-Type : application/json
{ "FeedCount":123 }
|
If No Data found, Response will be
Content-Type : application/json
{
"ERROR":"No Backup Data Found"
}
|
If SID not Subscribed to Feed based Protection, Response will be
Content-Type : application/json
{
"ERROR":"You are not subscribed to the ShieldSquare IP feed."
}
|
In case of any issues from ShieldSquare server end, Response will be
Content-Type : application/json
{
"ERROR":"Internal Server Error"
}
|
Note: There won't be any change in the DEL feed with respect to above features.
Write to support@shieldsquare.com if you want to make use of these services in your Feed-based Protection service package.
