Saltar al contenido principal
POST
curl
Añade una de las etiquetas de tu aplicación a una red, por ejemplo para marcarla para seguimiento o para dejar constancia de lo que concluyó tu equipo. Pasa el UUID de la etiqueta, tomado de las etiquetas de tu aplicación, como tag_uuid. Una etiqueta que pertenece a otra aplicación devuelve 404, igual que una etiqueta que no existe. La respuesta es el detalle completo de la red, con 201 cuando se añadió la etiqueta y 200 cuando la red ya la tenía. Volver a llamar a la API con la misma etiqueta no cambia nada, así que puedes reintentar sin riesgo. tags enumera las etiquetas de tu aplicación en la red, de la más antigua a la más reciente. added_by es null cuando una clave de API añadió la etiqueta, y el correo electrónico del miembro de la consola cuando la añadió un miembro. Los fraud_tags de la red, las etiquetas que llevan sus miembros, no se ven afectados.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

organization_id
string<uuid>
requerido

UUID de la organización.

application_id
string<uuid>
requerido

UUID de la aplicación.

network_uuid
string<uuid>
requerido

UUID de la red.

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Cuerpo

application/json
tag_uuid
string<uuid>
requerido

UUID de una de las etiquetas de tu aplicación.

Respuesta

La etiqueta ya estaba en la red y se deja tal como está. Devuelve el detalle de la red.

El detalle de la red, junto con el modo de compartición de la organización, si se le aplican las señales entre organizaciones, las etiquetas de tu aplicación en la red, los resultados de los miembros y las puntuaciones de patrones.

uuid
string<uuid>
network_id
string

ID secuencial legible por organización, p. ej. N-0001.

name
string | null
status
enum<string>

Estado del ciclo de vida de la red. Es distinto del outcome_status de cada solicitante dentro de una red (approved/in_review/declined/not_completed).

Opciones disponibles:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

Los patrones de agrupamiento detectados en esta red.

Opciones disponibles:
exact_same_device,
similar_device,
same_ip_address,
same_address,
similar_selfie_backgrounds,
similar_poa_documents,
same_document_number,
same_phone_number,
same_email
signal_types
enum<string>[]

Los distintos tipos de señal presentes en esta red.

Opciones disponibles:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

Recuentos de miembros por categoría (p. ej., total, por outcome_status).

member_status
object

Desglose de los miembros por outcome_status.

signal_coverage
object

Cobertura por signal_type de los miembros de esta red.

first_activity_at
string<date-time> | null
last_activity_at
string<date-time> | null
stats
object

Estadísticas agregadas de la red (p. ej., totales de miembros).

fraud_tags
object[]

Etiquetas de patrones de fraude detectadas en la red.

risk_signals
object

Resúmenes de señales de riesgo: residential_proxy_reuse, email_intelligence, phone_intelligence.

reviewed_at
string<date-time> | null
reviewed_by
string | null
review_reason
string | null
notes_count
integer
read-only

Número de notas privadas de analistas en esta investigación.

Rango requerido: x >= 0
sharing_mode
enum<string>

El modo de uso compartido entre organizaciones de la organización. Solo global compara redes entre organizaciones; private y off las limitan al historial propio de la organización.

Opciones disponibles:
off,
private,
global
Ejemplo:

"global"

cross_org_available
boolean

Indica si las señales entre organizaciones se aplican a esta organización. Requieren tanto el plan Enterprise como el modo de compartición global.

Ejemplo:

true

cross_org_unavailable_reason
enum<string> | null

Por qué no se aplican las señales entre organizaciones, comprobado en este orden. plan: el plan de la organización no incluye la red de fraude entre organizaciones (requiere el plan Enterprise), sea cual sea el modo de compartición. sharing_mode: el plan la incluye, pero el modo de compartición es private u off. Null cuando cross_org_available es true.

Opciones disponibles:
plan,
sharing_mode
Ejemplo:

null

tags
object[]

Las etiquetas de tu aplicación en la red, de la más antigua a la más reciente. Cada aplicación solo ve sus propias etiquetas. fraud_tags es independiente y no cambia: son las etiquetas que tienen los miembros de la red.

outcomes
object

Estado de las personas y empresas de la red. Cada miembro que puedes ver cuenta una vez, según el estado de su verificación más reciente que llegó a una decisión. Las partes de las transacciones no se cuentan.

patterns
object[]

Puntuaciones de patrones sobre toda la red. Actualmente, un elemento: background.

Última modificación el 1 de noviembre de 2026