Skip to content

abusix/global-reporting

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Global Reporting

Welcome to the Global Reporting Project! Abusix is revitalizing the Global Reporting Project, a free reporting service that aims to block network abuse. This project is designed to help with examples on how to submit XARF to our API endpoint. This repository contains simple examples in different programming languages demonstrating how to perform a POST request to our XARF API endpoint.

Table of Contents

Description

This project showcases examples of performing a POST request using different programming languages. The examples are available in JavaScript, Python, and Shell Script.

Getting Started

Prerequisites

Follow this document to get your API key: https://docs.abusix.com/data-channels/5q9CV1FJbGR3vWZqVAYrqa/submitting-data-via-the-api-to-data-channels/aJPW14NYRRAQqsGDZnfA4w

Before running the examples, ensure you have the following prerequisites installed:

  • Node.js and npm (for JavaScript)
  • Python and pip (for Python)
  • cURL (for Shell Script)

Running the Examples

  1. JavaScript:
  • Navigate to the javascript directory.
  • Update your API key
  • Install the required dependencies using npm install.
  • Run the example script using node post_request.js.
  1. Python:
  • Navigate to the python directory.
  • Update your API key
  • Install the required dependencies using pip install requests.
  • Run the example script using python post_request.py.
  1. Shell Script:
  • Navigate to the sh shell directory.
  • Update your API key
  • Make the shell script executable using chmod +x post_request.sh.
  • Run the example script using ./post_request.sh.

Responses

Successful:

status: 201 Created
{
	"state": "success",
	"id": "id-here"
} 

Incorrect API key:

status: 403 Forbidden
{
	"state": "error",
	"error": "permission denied"
}

Incorrectly formated XARF:

status: 400 Bad Request
{
	"state": "error",
	"error": "validation failed"
}

Contributing

Contributions are welcome! If you'd like to add more examples or improve existing ones, feel free to open a pull request.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published