Create a dispute
curl --request POST \
--url https://app.chainpatrol.io/api/v2/dispute/create \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"content": "<string>",
"email": "jsmith@example.com",
"description": "<string>"
}
'import requests
url = "https://app.chainpatrol.io/api/v2/dispute/create"
payload = {
"content": "<string>",
"email": "jsmith@example.com",
"description": "<string>"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({content: '<string>', email: 'jsmith@example.com', description: '<string>'})
};
fetch('https://app.chainpatrol.io/api/v2/dispute/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.chainpatrol.io/api/v2/dispute/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'content' => '<string>',
'email' => 'jsmith@example.com',
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.chainpatrol.io/api/v2/dispute/create"
payload := strings.NewReader("{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.chainpatrol.io/api/v2/dispute/create")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.chainpatrol.io/api/v2/dispute/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"content": "<string>",
"message": "<string>"
}{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}{
"code": "UNAUTHORIZED",
"message": "Authorization not provided",
"issues": []
}{
"code": "FORBIDDEN",
"message": "Insufficient access",
"issues": []
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}Disputas
Crear disputa
Create a new dispute for an asset via the external API. Requires API key.
POST
/
dispute
/
create
Create a dispute
curl --request POST \
--url https://app.chainpatrol.io/api/v2/dispute/create \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"content": "<string>",
"email": "jsmith@example.com",
"description": "<string>"
}
'import requests
url = "https://app.chainpatrol.io/api/v2/dispute/create"
payload = {
"content": "<string>",
"email": "jsmith@example.com",
"description": "<string>"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({content: '<string>', email: 'jsmith@example.com', description: '<string>'})
};
fetch('https://app.chainpatrol.io/api/v2/dispute/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.chainpatrol.io/api/v2/dispute/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'content' => '<string>',
'email' => 'jsmith@example.com',
'description' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.chainpatrol.io/api/v2/dispute/create"
payload := strings.NewReader("{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.chainpatrol.io/api/v2/dispute/create")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.chainpatrol.io/api/v2/dispute/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"content\": \"<string>\",\n \"email\": \"jsmith@example.com\",\n \"description\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"content": "<string>",
"message": "<string>"
}{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}{
"code": "UNAUTHORIZED",
"message": "Authorization not provided",
"issues": []
}{
"code": "FORBIDDEN",
"message": "Insufficient access",
"issues": []
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}Inicio rápido
Autenticación
Incluye tu clave de API en el encabezadoX-API-KEY:
X-API-KEY: <api-key>
Descripción general
El endpoint Crear disputa te permite crear una nueva disputa para un Asset (activo digital: URL, dirección, perfil, app, etc.) que fue reportado o bloqueado. Es útil cuando crees que un asset fue marcado por error o si quieres impugnar una decisión de bloqueo.Solicitud
const response = await fetch(
"https://app.chainpatrol.io/api/v2/dispute/create",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-KEY": "YOUR_API_KEY_HERE",
},
body: JSON.stringify({
content: "https://example-phishing-site.com",
email: "contact@yourdomain.com", // Optional if the API key is associated with a user that has an email
description:
"This is not a phishing site, it's our legitimate marketing site.", // Optional
}),
}
);
const data = await response.json();
console.log(data);
const response = await fetch(
"https://app.chainpatrol.io/api/v2/dispute/create",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-KEY": "YOUR_API_KEY_HERE",
},
body: JSON.stringify({
content: "https://example-phishing-site.com",
email: "contact@yourdomain.com", // Optional if the API key is associated with a user that has an email
description:
"This is not a phishing site, it's our legitimate marketing site.", // Optional
}),
}
);
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://app.chainpatrol.io/api/v2/dispute/create",
headers={
"Content-Type": "application/json",
"X-API-KEY": "YOUR_API_KEY_HERE",
},
json={
"content": "https://example-phishing-site.com",
"email": "contact@yourdomain.com", # Optional if the API key is associated with a user that has an email
"description": "This is not a phishing site, it's our legitimate marketing site." # Optional
},
)
data = response.json()
print(data)
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
content | string | Sí | La URL o el identificador de contenido que quieres disputar |
email | string | No* | Correo electrónico de contacto para la disputa. Obligatorio si la clave de API no está asociada a un usuario que tenga un correo |
description | string | No | Detalles adicionales o explicación de la disputa |
Respuesta
{
"id": "12345",
"content": "https://example-phishing-site.com"
}
Parámetros de la respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | El identificador único de la disputa creada |
content | string | El contenido (URL) que se disputó |
message | string | Mensaje opcional que proporciona información adicional |
Errores
| Código de estado | Código de error | Descripción |
|---|---|---|
| 400 | BAD_REQUEST | Parámetros de entrada no válidos, o ya existe una disputa para este asset con el correo electrónico indicado |
| 401 | UNAUTHORIZED | Falta la clave de API o no es válida |
| 404 | NOT_FOUND | El asset especificado no existe |
Notas
- Solo se puede crear una disputa por dirección de correo electrónico para un asset específico
- Si el asset solo está bloqueado en EthPhishingDetect pero no en ChainPatrol, se agregará automáticamente una nota a la disputa
- Todas las disputas creadas mediante la API tendrán una nota del sistema que indica que se crearon mediante la API
Autorizaciones
Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.
Cuerpo
application/json
¿Esta página le ayudó?