Obtener informes de una transacción

GET

/reports/{transaction_id}

curl --request GET \
  --url 'https://report.lbfraud.ironchip.com/reports/example?limit=20&page=1&since=30d&timeout=5s' \
  --header 'Authorization: <Authorization>'

• Producción

Devuelve los informes asociados a un identificador de transacción. Si la transacción todavía se está procesando, la petición espera hasta timeout a que el informe esté disponible, de modo que se puede pedir el informe inmediatamente después de enviar la transacción desde el SDK.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

transaction_id

required

string

Identificador de la transacción tal y como se envió desde el SDK.

Query Parameters

limit

integer format: int64

default: 20 >= 1 <= 100

Número máximo de informes por página. Máximo 100.

page

integer format: int64

default: 1

Página a devolver, empezando en 1.

since

string

default: 30d

Example

30d

Antigüedad máxima del informe, como número con sufijo de unidad (30d, 12h, 15m).

timeout

string

default: 5s

Example

5s

Tiempo máximo de espera a que el informe se genere, con sufijo de unidad (5s, 1m).

Responses

200

Informes de la transacción.

Media typeapplication/json

Array<object>

Informe de riesgo generado para una transacción.

object

id

Identificador del informe.

integer format: int64

application_id

Identificador de la aplicación.

string

transaction_id

Identificador de la transacción enviado desde el SDK.

string

timestamp

Momento de generación del informe, en nanosegundos desde la época Unix.

integer format: int64

descriptive_report

Resumen legible de los datos del informe.

string

event

Resultado de la evaluación de la transacción.

object

id

Identificador de la transacción en la aplicación.

string

timestamp

Marca temporal del evento.

integer format: int64

risk_assignment

Nivel de riesgo asignado.

string

Allowed values: fraud high_risk low_risk unknown_risk

fraud_cases

Casos de fraude o decisiones que motivan el nivel de riesgo.

Array<string>

user

object

id

Identificador del usuario en la aplicación del cliente.

string

device

object

id

Identificador único del dispositivo.

string

model

Modelo del dispositivo.

string

integrity

Señales de manipulación del dispositivo.

object

rooted

El dispositivo tiene root o jailbreak.

boolean

emulated

El dispositivo es un emulador.

boolean

debugged

La aplicación se ejecuta en modo depuración o no es una compilación de producción.

boolean

gps_spoofed

La señal GPS está siendo falseada.

boolean

sensors

Sensores disponibles en el dispositivo durante la transacción.

object

gps

El GPS está activado.

boolean

wifi

El wifi está activado.

boolean

wifi_connected

El dispositivo está conectado a una red wifi.

boolean

mobile_networks

El dispositivo puede leer redes móviles.

boolean

ip

object

address

object

country

Nombre del país.

string

country_code

Código de país ISO 3166-1 alfa-2

string

region

Región administrativa.

string

state

Provincia o estado.

string

city

Ciudad.

string

latitude

number format: double

longitude

number format: double

vpn

La conexión pasa por una VPN

boolean

tor

La conexión llega desde la red Tor.

boolean

location

Ubicación consolidada de la transacción.

object

id

Identificador de la ubicación.

string

location_type

Fuente de la ubicación.

string

Allowed values: ip geo wifi lte cdma wcdma gsm

address

object

country

Nombre del país.

string

country_code

Código de país ISO 3166-1 alfa-2

string

region

Región administrativa.

string

state

Provincia o estado.

string

city

Ciudad.

string

latitude

number format: double

longitude

number format: double

geo_location

Ubicación obtenida por GPS.

object

id

string

address

object

country

Nombre del país.

string

country_code

Código de país ISO 3166-1 alfa-2

string

region

Región administrativa.

string

state

Provincia o estado.

string

city

Ciudad.

string

latitude

number format: double

longitude

number format: double

em_location

Ubicación obtenida a partir del entorno radioeléctrico (redes wifi y móviles).

object

id

string

address

object

country

Nombre del país.

string

country_code

Código de país ISO 3166-1 alfa-2

string

region

Región administrativa.

string

state

Provincia o estado.

string

city

Ciudad.

string

latitude

number format: double

longitude

number format: double

extra_data

Datos adicionales enviados con la transacción (JSON libre).

object

key

additional properties

any

Example

[
  {
    "event": {
      "risk_assignment": "fraud",
      "fraud_cases": [
        "SIM Swapping / ATO",
        "Banned location"
      ]
    },
    "user": {
      "id": "usuario-123"
    },
    "ip": {
      "address": {
        "country_code": "ES"
      }
    },
    "location": {
      "location_type": "ip",
      "address": {
        "country_code": "ES"
      }
    },
    "geo_location": {
      "address": {
        "country_code": "ES"
      }
    },
    "em_location": {
      "address": {
        "country_code": "ES"
      }
    }
  }
]

400

Algún parámetro no es válido (por ejemplo, limit mayor que 100 o un timeout o since con formato incorrecto) o el cuerpo del feedback no es un JSON válido.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

401

La clave de API falta o no es válida.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

404

No hay informes para la aplicación o la transacción indicada.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}

500

Error interno del servidor.

Media typeapplication/json

object

error

Mensaje de error.

string

error_code

Código de error estable para tratarlo en el cliente.

string

cause

Causa detallada

string

traceability_id

Identificador para que soporte localice la petición.

string

Example ^generated

{
  "error": "example",
  "error_code": "example",
  "cause": "example",
  "traceability_id": "example"
}