Obtenga una lista de sus solicitudes | Documentación | IP Geolocation Bulk API | API WhoisXML

Obtenga una lista de sus peticiones

POST https://ip-geolocation.whoisxmlapi.com/api/bgservice/request/list

Muestra de solicitud CURL

curl https://ip-geolocation.whoisxmlapi.com/api/bgservice/request/list -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "page": 1, "onlyIds": false, "perPage": 10, "sort": "desc", "format": "json"}'

Ejemplo de cuerpo de solicitud POST

{
    "apiKey": "YOUR_API_KEY",
    "page": 1,
    "format": "json",
    "onlyIds": false,
    "perPage": 10,
    "sort": "desc"
}

Parámetros de entrada

apiKey

Es necesario. Obtenga su clave API personal en la página Mis productos.

página

Opcional. Entero.

Se utiliza para paginar los conjuntos de resultados junto con 'perPage'.

Valor por defecto: 1.

onlyIds

Opcional. Booleano.

Cuando es verdadero sólo se devuelve la lista de IDs.

Valor por defecto: verdadero.

perPage

Opcional. Entero.

Limita cada página del conjunto de resultados a este número de peticiones.

Mín: 10; Máx: 50.

Valor por defecto: 10

ordenar

Opcional. Cadena.

Especifique el orden de las solicitudes en la respuesta.

Valores permitidos: "asc", "desc".

Valor por defecto: "desc".

formato

Opcional. Cadena.

Se utiliza para especificar el formato de la respuesta.

Valores permitidos: "xml", "json", "csv".

Valor por defecto: "json".

Muestra de salida

{
    "response": {
        "current_page": 1,
        "data": [
            {
                "id": 596
            },
            {
                "id": 595
            },
            {
                "id": 544
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.
{
    "response": {
        "current_page": 1,
        "data": [
            {
                "id": 596,
                "date_start": "1528377253",
                "total_terms": 3,
                "invalid_terms": 0,
                "processed_terms": 3,
                "failed_terms": 0,
                "ready": 1
            },
            {
                "id": 595,
                "date_start": "1528377227",
                "total_terms": 20,
                "invalid_terms": 0,
                "processed_terms": 20,
                "failed_terms": 0,
                "ready": 1
            },
            {
                "id": 544,
                "date_start": "1528204702",
                "total_terms": 500,
                "invalid_terms": 0,
                "processed_terms": 500,
                "failed_terms": 0,
                "ready": 1
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.

Parámetros de entrada

respuesta

El objeto de respuesta.

Contiene el campo 'datos ' con una matriz de datos de las solicitudes del usuario en caso de éxito.

Los campos "de" y "a " representan el rango de ID del conjunto de resultados de las peticiones devueltas para la página actual.

'per_page' es el tamaño de las páginas y 'total ' es el número de peticiones en el conjunto de resultados.

Los valores "página_actual" y " última_página " corresponden al número de páginas del conjunto de resultados.

En caso de error, contiene su descripción en el campo ' error'. Si hay varios errores se devuelven sus descripciones en el array ' errores '.

datos

Array.

Una lista de los elementos de información de sus solicitudes (si 'onlyIds ' es verdadero, cada elemento sólo tiene el campo 'id ').

datos[k].id

El objeto de respuesta.

ID de solicitud.

datos[k].fecha_inicio

Cuerda.

Representación en cadena de la marca de tiempo Unix de inicio de la solicitud.

datos[k].total_terms

Entero.

El total del número de términos (IP, correos electrónicos, nombres de dominio) en la solicitud.

datos[k].términos_no_válidos

Entero.

Número de términos no válidos.

datos[k].términos_procesados

Entero.

Número de términos ya procesados.

datos[k].términos_fallidos

Entero.

Número de términos que no se han podido procesar.

data[k].ready

Entero.

1 si el tratamiento ha finalizado, 0 - en caso contrario.

de

Entero.

ID mín. de solicitud en la página actual del conjunto de datos.

a

Entero.

ID máx. de solicitud en la página actual del conjunto de datos.

por_página

Entero.

Número máximo de solicitudes para cada página del conjunto de resultados.

total

Entero.

El número total de solicitudes en el conjunto de resultados.

página_actual

Entero.

Número de página actual en el conjunto de resultados.

última_página

Entero.

El número de la última página del conjunto.

error

Cuerda.

Descripción del error.

errores

Array.

Múltiples mensajes de error.