API Jestyc Contacts

La liste des requêtes de l'outil de gestion des contacts :

Pour effectuer une requête sur un outil, vous devez disposer d'un token valide et de l'ID de l'outil (plus de détails).

Contact

Cette requête vous permet de récupérer toutes les données d'un contact en fonction de son ID (l'ID du contact peut être obtenu avec Contacts ou avec ContactWrite lorsque vous ajoutez un nouveau contact).

https://api.jestyc.com/v1/Contact
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123,
        "contact_id": 4567
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)
contact_idID du contact (requis)

Exemple de réponse au format JSON :

{
    "id": "4567",
    "creation_date": "1600024102",
    "created_by": {
        "id": null,
        "name": null
    },
    "edition_date": "1600419470",
    "edited_by": {
        "id": "345",
        "name": "Sébastien"
    },
    "group": {
        "id": "456",
        "name": "Clients"
    },
    "data_1": "",
    "data_2": "Exemple",
    "data_3": "René",
    "data_4": "Boatte SA",
    "data_5": "",
    "data_6": "Gérant",
    "data_7": "",
    "data_8": "",
    "data_9": "rene@exemple.com",
    "data_10": "",
    "data_11": "",
    "data_12": "8, rue de la Venue",
    "data_13": "",
    "data_14": "12345",
    "data_15": "Lavylle",
    "data_16": "France",
    "data_17": "0123456789",
    "data_18": "",
    "data_19": "",
    "data_20": "",
    "data_21": "",
    "data_22": "",
    "data_23": "",
    "data_24": "",
    "data_25": "",
    "data_26": "",
    "data_27": "",
    "data_28": "",
    "data_29": "Exemple de remarque."
}

ContactDelete

Cette requête vous permet de supprimer un contact en fonction de son ID (l'ID du contact peut être obtenu avec Contacts ou avec ContactWrite lorsque vous ajoutez un nouveau contact).

https://api.jestyc.com/v1/ContactDelete
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123,
        "contact_id": 4567
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)
contact_idID du contact (requis)

Exemple de réponse au format JSON :

{
    "request": "success"
}

Contacts

Cette requête vous permet de récupérer les données de tous les contacts qui répondent aux critères de recherche définis (ou tous les contacts si vous ne définissez aucun critère de recherche).

https://api.jestyc.com/v1/Contacts
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123,
        "search_0": 456,
        "search_2": "no",
        "search_9": "@",
        "order_by": 4,
        "order_asc": 1,
        "limit": 10,
        "page": 1
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)
search_0Recherche dans un groupe en fonction de son ID (facultatif)
search_[1-29]Recherche dans un des 29 autres champs (facultatif, utilisable plusieurs fois)
order_byNuméro du champ utilisé pour le tri (facultatif)
  • 0 - 29 : tri en fonction de l'un des 30 champs
  • 30 : tri en fonction de la date de modification
  • 31 : tri en fonction de la date de création
order_ascMode de tri (facultatif, par défaut : 1)
  • 0 : décroissant
  • 1 : croissant
limitNombre de résultats au maximum (facultatif)
pagePage de résultats (facultatif, par défaut : 1, requiert le paramètre "limit")

Exemple de réponse au format JSON :

[
    {
        "id": "21636",
        "creation_date": "1600024102",
        "created_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Notzcymk",
        "data_3": "Dcqolf",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "949567571",
        "data_8": "",
        "data_9": "rovasi.cwrhysiz@budwxzj.tl",
        "data_10": "voc.arwcnwc.fc",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": "_x000D_"
    },
    {
        "id": "23392",
        "creation_date": "1600024102",
        "created_by": {
            "id": "346",
            "name": "Paul"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "346",
            "name": "Paul"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "Monsieur",
        "data_2": "Girdnov",
        "data_3": "Bqtv-Rjfx",
        "data_4": "",
        "data_5": "",
        "data_6": "Ezosrrrpjb oefvpkpuw",
        "data_7": "",
        "data_8": "",
        "data_9": "pqfa-tfjc.kacxhsa@drtunoz.mj",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "Nymdkajlqb kimgtpueo",
        "data_25": "PVE",
        "data_26": "Rfjuewg",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    },
    {
        "id": "23524",
        "creation_date": "1600024102",
        "created_by": {
            "id": null,
            "name": null
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": null,
            "name": null
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Hddftb-Qfnody",
        "data_3": "Qjeq",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "7774655111",
        "data_8": "",
        "data_9": "qhftrbnnty@vcxjcre.tn",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    },
    {
        "id": "23582",
        "creation_date": "1600024102",
        "created_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Hnovmc",
        "data_3": "Vguuhrnzs",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "2056665401",
        "data_8": "",
        "data_9": "rdehgp.lcnjtlxcc@xdrro.jvb",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "Mxh kq wj Omxasb 2",
        "data_19": "",
        "data_20": "683",
        "data_21": "Qrtpx",
        "data_22": "Nlvznb",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    },
    {
        "id": "23968",
        "creation_date": "1600024102",
        "created_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Kbnobv",
        "data_3": "Glkcobws",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "48551042",
        "data_8": "",
        "data_9": "qepvgsiv@vgbxfszdmdhau.jf",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    },
    {
        "id": "24193",
        "creation_date": "1600024102",
        "created_by": {
            "id": "346",
            "name": "Paul"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "346",
            "name": "Paul"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Llpaluy-Bjbzno",
        "data_3": "Bthertz",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "3491 16 655 44 30",
        "data_8": "",
        "data_9": "cjlosie.vvpblne@isopv.gdt",
        "data_10": "",
        "data_11": "12.21.0623",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "Dttj",
        "data_16": "Bazvof",
        "data_17": "",
        "data_18": "Mgt pud Yruwvawhps 3",
        "data_19": "",
        "data_20": "5481",
        "data_21": "Rlna",
        "data_22": "Fpmogu",
        "data_23": "904 789 64 81",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": "_x000D_"
    },
    {
        "id": "24524",
        "creation_date": "1600024102",
        "created_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Noxsi",
        "data_3": "Cvscnts",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "",
        "data_8": "",
        "data_9": "efuhozz.kgjzi@zmsfnxt.io",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    },
    {
        "id": "25901",
        "creation_date": "1600024102",
        "created_by": {
            "id": "346",
            "name": "Paul"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "346",
            "name": "Paul"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "W'ukzzvcl-Xgnobuf",
        "data_3": "Yqziw",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "185 680 07 71",
        "data_8": "",
        "data_9": "ccsdk.wrukhefn@vdvnrje.li",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "Jnnxvy",
        "data_21": "",
        "data_22": "",
        "data_23": "226 121 49 36",
        "data_24": "Nmltdd",
        "data_25": "GL",
        "data_26": "Dloujy",
        "data_27": "",
        "data_28": "",
        "data_29": "_x000D_"
    },
    {
        "id": "26209",
        "creation_date": "1600024102",
        "created_by": {
            "id": null,
            "name": null
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": null,
            "name": null
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "YXKYNT CIIXKHXBN KIQNOVLF",
        "data_3": "",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "",
        "data_8": "",
        "data_9": "qvykyvedpsk@yuneqdg.vf",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "E. Xrmx-Malinfge Ssvno, penowsbvv Wxt Uxcdajm 2",
        "data_19": "",
        "data_20": "ZXEUGXVT",
        "data_21": "47",
        "data_22": "",
        "data_23": "622 123 59 41",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": "Xzwuobrf : Q rkrw5343"
    },
    {
        "id": "27988",
        "creation_date": "1600024102",
        "created_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "edition_date": "1600024102",
        "edited_by": {
            "id": "345",
            "name": "Sébastien"
        },
        "group": {
            "id": "456",
            "name": "Clients"
        },
        "data_1": "",
        "data_2": "Gnodop",
        "data_3": "Randvmsf",
        "data_4": "",
        "data_5": "",
        "data_6": "",
        "data_7": "",
        "data_8": "",
        "data_9": "cinzkvzb_evhhdd@zspydrs.wwj",
        "data_10": "",
        "data_11": "",
        "data_12": "",
        "data_13": "",
        "data_14": "",
        "data_15": "",
        "data_16": "",
        "data_17": "",
        "data_18": "",
        "data_19": "",
        "data_20": "",
        "data_21": "",
        "data_22": "",
        "data_23": "",
        "data_24": "",
        "data_25": "",
        "data_26": "",
        "data_27": "",
        "data_28": "",
        "data_29": ""
    }
]

ContactsGroups

Cette requête vous permet d'obtenir la liste des groupes et leurs ID respectifs.

https://api.jestyc.com/v1/ContactsGroups
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)

Exemple de réponse au format JSON :

{
    "455": "Amis",
    "456": "Clients",
    "457": "Divers"
}

ContactsLabels

Cette requête vous permet de récupérer les noms des 30 champs.

https://api.jestyc.com/v1/ContactsLabels
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)

Exemple de réponse au format JSON :

{
    "label_0": "Groupe",
    "label_1": "Civilité",
    "label_2": "Nom",
    "label_3": "Prénom",
    "label_4": "Entreprise",
    "label_5": "Service",
    "label_6": "Fonction",
    "label_7": "Téléphone",
    "label_8": "Portable",
    "label_9": "Email",
    "label_10": "Site Internet",
    "label_11": "Date de naissance",
    "label_12": "Adresse",
    "label_13": "Adresse (2)",
    "label_14": "Code postal",
    "label_15": "Ville",
    "label_16": "Pays",
    "label_17": "Téléphone",
    "label_18": "[2] Adresse",
    "label_19": "[2] Adresse (2)",
    "label_20": "[2] Code postal",
    "label_21": "[2] Ville",
    "label_22": "[2] Pays",
    "label_23": "[2] Téléphone",
    "label_24": "Autre champ (1)",
    "label_25": "Autre champ (2)",
    "label_26": "Autre champ (3)",
    "label_27": "Autre champ (4)",
    "label_28": "Autre champ (5)",
    "label_29": "Remarques"
}

ContactWrite

Cette requête vous permet d'ajouter un nouveau contact ou de modifier un contact existant (si l'ID du contact est renseigné, il s'agira d'une modification et s'il n'est pas renseigné ce sera un ajout).

https://api.jestyc.com/v1/ContactWrite
{
    "p": {
        "token": "TOKEN",
        "tool_id": 123,
        "contact_id": 4567
    },
    "d": {
        "data_0": 345,
        "data_2": "Nom",
        "data_3": "Prénom",
        "data_9": "api@exemple.com"
    }
}
tokenToken (requis)
tool_idID de l'outil (requis)
contact_idID du contact (requis pour une modification, non requis pour un ajout)

Entrez dans le second tableau uniquement les valeurs des champs à modifier (ou des champs renseignés en cas d'ajout) :

data_0ID du groupe (facultatif)
data_[1-29]Valeur du champ (facultatif, utilisable pour chacun des 29 autres champs)

Exemple de réponse au format JSON :

{
    "request": "success"
}
S'il s'agit d'un ajout, la réponse contient également l'ID du nouveau contact.