AvancéFAQ-FR

Comment importer/exporter des données avec BizzCardz ?

juillet 17, 2023 BizzCardz Team

213 Views

Importer et exporter des données avec BizzCardz est pratique et se fait le plus simplement possible avec une clé API.
Pour créer une clé API, connectez-vous à la plateforme admin de BizzCardz à cette adresse : https://admin.bizzcardv2-last-eu.hidora.com/. Une fois connecté, cliquez sur le lien Paramètres/Import et export.

Sur la page de l’export et import, cliquez sur le bouton + Générer une nouvelle clé API. Dans le formulaire qui s’affiche, renseignez le nom de la clé API et cliquez sur le bouton Générer la clé.

Une fois enregistré, vous avez un message de succès et la valeur de votre clé API. Attention! cette valeur ne sera affichée qu’une seule fois donc, veuillez à cette étape sauvegarder votre clé quelque part.

Import de données

l’import de données dans BizzCardz accepte que le format json. Ci-dessous un exemple de json que vous pouvez envoyer :

[
    {
        "first_name": "John",
        "last_name": "Doe",
        "user_email": "johndoeoe@monsite.com",
        "phone_number": "+32 (0) 00 00 00 00"
    },
    {
        "first_name": "Martin",
        "last_name": "Martin",
        "user_email": "martin@monsite.com",
        "phone_number": "+32 (0) 01 01 01 21"
    },
    {
        "first_name": "Bruno",
        "last_name": "T.",
        "user_email": "bruno@monsite.com",
        "phone_number": "+32 (0) 02 02 02 02"
    },
    {
        "first_name": "Carl",
        "last_name": "B.",
        "user_email": "carl@monsite.com",
        "phone_number": "+32 (0) 03 03 03 03"
    },
    {
        "first_name": "Sylvie",
        "last_name": "C.",
        "user_email": "sylvie@monsite.com",
        "phone_number": "+32 (0) 04 04 04 04"
    }
]

Exemples de codes pour importer des données dans BizzCardz

Ces codes sont à titre indicatif. Vous devez les adapter selon votre contexte

PHP

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://admin.bizzcardv2-last-eu.hidora.com/fr/api/vcard/import/",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => /* Votre objet JSON à envoyer */,
    CURLOPT_COOKIE => "Path=%2F",
    CURLOPT_HTTPHEADER => [
        "Accept: application/json",
        "Authorization: Api-Key jsk28faE.hbbdV02aVN0lBI+GB09urlBJIOM36LJ9",
        "Content-Type: application/json"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}

Javascript

const axios = require('axios');

const url = "https://admin.bizzcardv2-last-eu.hidora.com/fr/api/vcard/import/";
const apiKey = "jsk28faE.hbbdV02aVN0lBI+GB09urlBJIOM36LJ9";
const json = /* votre objet JSON à envoyer */;

axios({
  method: 'post',
  url: url,
  headers: {
    'Accept': 'application/json',
    'Authorization': `Api-Key ${apiKey}`,
    'Content-Type': 'application/json',
    'Cookie': 'Path=%2F'
  },
  data: json,
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error("Error:", error.message);
});

N’oubliez pas de remplacer /* votre objet JSON à envoyer */ par l’objet JSON que vous souhaitez envoyer dans votre requête POST. La réponse de la requête sera affichée dans la console, ou vous pouvez la manipuler comme vous le souhaitez dans la fonction de rappel then. En cas d’erreur, le message d’erreur sera affiché dans la console, ou vous pouvez également traiter l’erreur dans la fonction de rappel catch.

Python

import requests

url = "https://admin.bizzcardv2-last-eu.hidora.com/fr/api/vcard/import/"
api_key = "jsk28faE.hbbdV02aVN0lBI+GB09urlBJIOM36LJ9"
json_data = # Votre objet JSON à envoyer

headers = {
    "Accept": "application/json",
    "Authorization": f"Api-Key {api_key}",
    "Content-Type": "application/json",
    "Cookie": "Path=%2F"
}

response = requests.post(url, json=json_data, headers=headers)

if response.ok:
    print(response.json())
else:
    print("Erreur cURL #:", response.text)

Assurez-vous de remplacer # Votre objet JSON à envoyer par l’objet JSON que vous souhaitez envoyer dans votre requête POST. La réponse de la requête sera affichée dans la console si la réponse est valide (code HTTP 200), sinon le message d’erreur de cURL sera affiché.

Export de données

BizzCardz exporte les données en json. Ci-dessous un exemple de json qui peut être exporté :

{
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1,
            "first_name": "Vincent",
            "last_name": "MOULE",
            "company_position": "Directeur",
            "email": "vincent@monsite.com",
            "phone_number": "+32 (0) 60 30 80 50",
            "linkedin": "",
            "hobbies": "",
            "education": "",
            "company_name": "Ma société",
            "company_activity_type": "Informatique",
            "company_website": "https://www.monsite.com/",
            "company_postal_address": "8, rue Pierre-Paul Duménil",
            "company_postal_code": "7000",
            "company_city": "Mons",
            "company_country": "BE",
            "company_email": "contact@monsite.com",
            "company_phone_number": "+32 60 30 80 50",
            "scan_picture": null,
            "scan_notes": null,
            "scan_vocal_note": null,
            "meta_scanned_at": "",
            "meta_scanned_by": "",
            "meta_scan_type": ""
        },
        {
            "id": 2,
            "first_name": "Phylippe",
            "last_name": "Yoss",
            "company_position": "manager",
            "email": "phylippe@monsite.com",
            "phone_number": "+32 (0) 70 40 70 30",
            "linkedin": "",
            "hobbies": "",
            "education": "",
            "company_name": "Ma société",
            "company_activity_type": "Informatique",
            "company_website": "https://www.monsite.com/",
            "company_postal_address": "8, rue Pierre-Paul Duménil",
            "company_postal_code": "7000",
            "company_city": "Mons",
            "company_country": "BE",
            "company_email": "contact@monsite.com",
            "company_phone_number": "+32 (0) 70 40 70 30",
            "scan_picture": null,
            "scan_notes": null,
            "scan_vocal_note": null,
            "meta_scanned_at": "",
            "meta_scanned_by": "",
            "meta_scan_type": ""
        },
        {
            "id": 2,
            "first_name": "Judith",
            "last_name": "Vampour",
            "company_position": "Gérante",
            "email": "judith@monsite.com",
            "phone_number": "+32 (0) 60 60 70 50",
            "linkedin": "",
            "hobbies": "",
            "education": "",
            "company_name": "Ma société",
            "company_activity_type": "Informatique",
            "company_website": "https://www.monsite.com/",
            "company_postal_address": "8, rue Pierre-Paul Duménil",
            "company_postal_code": "7000",
            "company_city": "Mons",
            "company_country": "BE",
            "company_email": "contact@monsite.com",
            "company_phone_number": "+32 (0) 60 60 70 50",
            "scan_picture": null,
            "scan_notes": null,
            "scan_vocal_note": null,
            "meta_scanned_at": "",
            "meta_scanned_by": "",
            "meta_scan_type": ""
        }
    ]
}