Enrichissez votre premier contact avec l'API Dropcontact en deux étapes : envoyez le contact, puis récupérez le résultat.

Ce guide enrichit un contact : Denis Cohen, de l'entreprise Dropcontact.

## Avant de commencer

Vous avez besoin d'un [compte Dropcontact](https://app.dropcontact.com/) et d'une clé API.

1. [Créez et copiez votre clé API](https://app.dropcontact.com/api) dans l'app.
2. Renseignez-la une fois en début de script, elle sera réutilisée dans toutes les requêtes :

```python

apiKey = "VOTRE_CLE_API"
```

Dans les exemples Shell, remplacez `VOTRE_CLE_API` par votre clé API.

## Étape 1 : envoyer le contact

**Python**

```python
r = requests.post(
    "https://api.dropcontact.com/v1/enrich/all",
    json={
        "data": [
            {
                "first_name": "Denis",
                "last_name": "Cohen",
                "website": "dropcontact.com",
                "email": "dc@dropcontact.io",
            }
        ],
        "siren": True,
    },
    headers={
        "Content-Type": "application/json",
        "X-Access-Token": apiKey,
    },
)
print(r.json())
```

**Shell**

```shell
curl -X POST https://api.dropcontact.com/v1/enrich/all \
  -H "X-Access-Token: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"data": [{"first_name": "Denis", "last_name": "Cohen", "website": "dropcontact.com", "email": "dc@dropcontact.io"}], "siren": true}'
```

Retrouvez tous les champs et options que vous pouvez envoyer dans [Contact envoyé](https://developer.dropcontact.com/fr/reference/input-record/).

L'API répond :

```json
{
  "credits_left": 15279,
  "request_id": "qzmxkpvlrtdnhwa",
  "error": false,
  "success": true
}
```

Conservez le `request_id` : il vous servira à l'étape 2.

## Étape 2 : récupérer le résultat

L'enrichissement prend quelques secondes. Remplacez `REQUEST_ID` par le `request_id` obtenu à l'étape 1, puis lancez la requête.

**Python**

```python
r = requests.get(
    "https://api.dropcontact.com/v1/enrich/all/REQUEST_ID",
    headers={"X-Access-Token": apiKey},
)
print(r.json())
```

**Shell**

```shell
curl https://api.dropcontact.com/v1/enrich/all/REQUEST_ID \
  -H "X-Access-Token: VOTRE_CLE_API"
```

Si le résultat n'est pas encore prêt, l'API renvoie `"success": false`. Relancez la même requête 30 secondes plus tard.

```json
{
  "error": false,
  "reason": "Request not ready yet, try again in 30 seconds",
  "success": false
}
```

Une fois le résultat prêt, l'API renvoie un objet par contact, dans l'ordre d'envoi :

```json
{
  "data": [
    {
      "first_name": "Denis",
      "last_name": "Cohen",
      "full_name": "Denis Cohen",
      "civility": "Monsieur",
      "linkedin": "www.linkedin.com/in/cohendenis",
      "location": "Paris, Île-de-France, France",
      "email": [
        {
          "email": "dc@dropcontact.io",
          "qualification": "nominatif@pro"
        }
      ],
      "company": "Dropcontact",
      "website": "www.dropcontact.com",
      "siret_address": "7 Place de l'Hôtel de Ville",
      "siret_zip": "93600",
      "siret_city": "Aulnay-sous-Bois",
      "country": "France",
      "company_linkedin": "www.linkedin.com/company/dropcontact-email-finder",
      "phone": "+33 1 23 45 67 89",
      "company_turnover": "",
      "company_results": "",
      "nb_employees": "10-19",
      "siren": "823752647",
      "siret": "82375264700029",
      "naf5_code": "62.01Z",
      "naf5_des": "Programmation informatique",
      "vat": "FR11823752647",
      "industry": "Technology, Information and Internet",
      "employee_count": "15"
    }
  ],
  "credits_left": 15279,
  "error": false,
  "success": true
}
```

Le champ `qualification` indique le niveau de fiabilité de chaque email. Retrouvez tous les champs du résultat dans [Contact enrichi](https://developer.dropcontact.com/fr/reference/enriched-record/).

## Étapes suivantes

- [Webhooks](https://developer.dropcontact.com/fr/webhooks/) : recevez le résultat directement sur votre serveur, sans relancer la requête.
- [Erreurs](https://developer.dropcontact.com/fr/errors/) : que faire quand une requête échoue.
- [Crédits](https://developer.dropcontact.com/fr/credits/) : à quel moment un crédit est utilisé.
- [Référence de l'API](https://developer.dropcontact.com/fr/reference/) : tous les endpoints et tous les champs.