Formuler des demandes

Exemple de corps de requête

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "soa",
    "terms": [
        {
            "field": "domain",
            "term": "google.com"
        }
    ]
}

Cette requête renvoie tous les enregistrements SOA pour le domaine"google.com".

Vous pouvez également utiliser la recherche par caractères génériques. Dans ce cas, le terme se présente comme suit "google*". De telles demandes prennent plus de temps à traiter, il faut donc éviter les recherches trop larges.

Exemple de corps de requête

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        }
    ]
}

Cette requête renvoie tous les enregistrements SOA correspondant au terme recherché. Dans notre exemple, il s'agit de : commençant par "ns1.google".

Dans la plupart des cas, les termes de recherche sont des caractères génériques. Vous pouvez utiliser des caractères génériques de fin, de début ou les deux à la fois :
"ns1.google*", "*ns1.google", "*ns1.google*".

Exclure les termes demande corps exemple

Vous pouvez ajouter des termes de recherche pour exclure des enregistrements du résultat.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        },
        {
            "field": "value",
            "term": "*googledomains.com*",
            "exclude": true
        }
    ]
}

Cette requête renvoie tous les enregistrements SOA qui commencent par "ns1.google" et qui n'incluent pas "googledomains.com".

Exemple de corps de requête

Vous pouvez utiliser jusqu'à 4 termes de recherche de types différents dans une même demande.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "soa",
    "terms": [
        {
            "field": "value",
            "term": "ns1.google*"
        },
        {
            "field": "domain",
            "term": "1bgo9ev2in.com"
        }
    ]
}

Cette requête renvoie tous les enregistrements SOA qui commencent par "ns1.google"et qui sont liés au domaine"1bgo9ev2in.com" .

Exclure les termes demande corps exemple

Vous pouvez ajouter des termes de recherche pour exclure des enregistrements du résultat.

{
    "apiKey": "YOUR_API_KEY",
    "limit": 1000,
    "recordType": "txt",
    "terms": [
        {
            "field": "domain",
            "term": "twitter.com"
        },
        {
            "field": "value",
            "term": "*verification*"
        },
        {
            "field": "value",
            "term": "*domain*",
            "exclude": true
        }
    ]
}

Cette requête renvoie tous les enregistrements TXT qui contiennent "vérification"mais qui n'incluent pas "domain"et qui concernent le domaine "twitter.com".