The terms of use gather all the rules to follow to use the API.

Your API key and the grains of salt of the checksums must remain secret, they represent your private parameters. It is strictly forbidden to communicate them to third parties. For security reasons, if one of these rules is not respected, we would be forced to deactivate your API key.

It is strongly recommended to use cache if you are using the API to display your rating and reviews on your site. This will ensure that the display of your page does not depend on the API responses and therefore does not affect its display time.

On your website:

You must clearly display the source of the reviews, namely Aviseniors. Thus, the Aviseniors logo or the label of confidence must appear clearly on the page displaying the reviews, with a link in the href, scanned by the search engines, and pointing towards the company file of the Aviseniors site. This point is essential so that search engines can make the link between the 2 pages, and avoid duplicate content. The review pages of your site must be validated by our partnership department before being put into production. You must also display a textual mention indicating that the reviews come from the Aviseniors site.

Our partnership manager can be reached at 07 88 50 48 11 or by email at agnes@aviseniors.com

On other communication supports:

You must always display the Aviseniors logo and indicate that the reviews are from the Aviseniors solution.

In requests, the order of fields is crucial for successful processing. Ensure that fields are sent in the exact sequence specified in the documentation; any deviation in order may result in errors. Please follow the defined field structure precisely to avoid issues.

For each call to the API, a checksum must be sent. This checksum is calculated as follows:

Concatenation of the following values, all formatted in SHA1 :

• apikey
• values of parameters sent in the order specified in the doc, formatted in JSON for arrays and objects.
• checksum_salt_in

PHP code example

private function calcChecksumIn($api_key, $checksum_salt_in, $datas = array())
    {
        $checksum = "";
        $checksum .= $api_key;
        foreach ($datas as $k => $v) {
            if ($v instanceof File) {
                $file = $v->getFilename();
                $file .= $v->getMimeType();
                $file .= $v->getSize();
                $v = $file;
            } elseif (is_array($v) || is_object($v)) {
                $v = json_encode($v, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
            } elseif ($v === true) {
                $v = 1;
            } elseif ($v === false) {
                $v = 0;
            }
            $checksum .= $v;
        }
        $checksum .= $checksum_salt_in;
        return sha1($checksum);
    }

Company's informations

Management of pros

A pro account must be associated with at least one of the companies linked to the partner.

If a pro account is associated with a brand, it is automatically considered as associated with all the companies in the park managed by the brand. If it is associated with a company in the park, it is considered as an unnecessary duplication, even if it is tolerated.

Management of reviews

These services allow you to recover all the reviews and to automate the collection with your your information system.

Solicitation information

Solicitations are the collection of e-mail or SMS sent to prospects to make them depositaries.

Management of surveys

Customized surveys are defined by brand or company and can replace the default survey for filing reviews.

Endpoint utilities