L'API Zoneurs.net permet aux développeurs et éditeurs de contenus d'automatiser le chiffrement et la protection de leurs liens directement depuis leurs scripts applicatifs ou systèmes de gestion de contenu (CMS).

Spécification de l'API REST Zoneurs.net

L'API accepte les requêtes POST au format JSON ou application/x-www-form-urlencoded et retourne une réponse JSON standardisée.

Point d'accès (Endpoint) :

POST https://zoneurs.net/api.php

Exemple d'intégration en PHP

Voici comment convertir automatiquement une URL brute en lien Zoneurs.net sécurisé en PHP :

<?php
function protect_url_api($url) {
    $endpoint = "https://zoneurs.net/api.php";
    $ch = curl_init($endpoint);
    
    $payload = http_build_query([
        "action" => "protect",
        "url"    => $url
    ]);
    
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $data = json_decode($response, true);
    return ($data && $data["success"]) ? $data["protected_url"] : false;
}

$lien_securise = protect_url_api("https://exemple.com/mon-fichier-prive.zip");
echo "Lien protégé : " . $lien_securise;
?>

Exemple d'intégration en Python

Pour les scripts d'automatisation ou pipelines de traitement de données :

import requests

def get_protected_link(target_url):
    api_url = "https://zoneurs.net/api.php"
    response = requests.post(api_url, data={"url": target_url})
    
    if response.status_code == 200:
        result = response.json()
        if result.get("success"):
            return result.get("protected_url")
    return None

link = get_protected_link("https://exemple.com/document.pdf")
print("Protected Link:", link)

Gestion des erreurs et meilleures pratiques

Consultez la réponse HTTP et les champs JSON retournés :

  • {"success": true, "protected_url": "..."} : Génération réussie.
  • {"success": false, "error": "URL invalide"} : Erreur dans le lien transmis.

Pour intégrer l'API sur vos projets à fort trafic, consultez notre documentation sur la page API Zoneurs.net.