Portail développeurs CaleDoHub

🚀 Démarrage rapide 5 min

Tester l'API en 30 secondes — aucune authentification requise pour les endpoints publics en lecture.

# Récupérer 10 pros à Nouméa
curl "https://caledohub.com/api/pros.json?commune=Nouméa&limit=10"

# Stats globales temps réel
curl "https://caledohub.com/api/stats.json"

# Voir la doc OpenAPI complète
curl "https://caledohub.com/api/openapi.json" | jq .

✅ Aucune clé API requise pour les endpoints en lecture. Cache 5 min protège le upstream. Limite douce ~100 req/min.

🔌 6 endpoints disponibles

GET/api/pros.json

Liste pros avec filtres commune/category/tier/limit/demo

GET/api/stats.json

Agrégats temps réel : total, communes, catégories, tiers

GET/api/communes.json

Distribution par commune (alias stats)

GET/api/categories.json

Top catégories actives (alias stats)

GET/api/reviews.json

Reviews approuvées (filter proId optionnel) · ⚠️ Bêta

POST/api/indexnow.json

Submit URLs Bing/Yandex via IndexNow · Auth header requis

📋 Spec OpenAPI 3.0 🛠️ Ouvrir dans Swagger UI

💻 Exemples de code

Récupérer la liste des restaurants à Nouméa dans différents langages :

curl -s "https://caledohub.com/api/pros.json?commune=Nouméa&category=Restaurant&limit=20" \
  | jq '.pros[] | {name, phone, address}'

// Fetch pros (navigateur ou Node 18+)
const res = await fetch('https://caledohub.com/api/pros.json?commune=Nouméa&category=Restaurant&limit=20');
const data = await res.json();
console.log(`${data.pros.length} restaurants à Nouméa`);
data.pros.forEach(p => console.log(p.name, '·', p.phone || '—'));

import requests

resp = requests.get(
    'https://caledohub.com/api/pros.json',
    params={'commune': 'Nouméa', 'category': 'Restaurant', 'limit': 20},
    timeout=10
)
data = resp.json()
print(f"{len(data['pros'])} restaurants à Nouméa")
for p in data['pros']:
    print(f"- {p['name']} · {p.get('phone', '—')}")

<?php
$url = 'https://caledohub.com/api/pros.json?commune=' . rawurlencode('Nouméa')
     . '&category=Restaurant&limit=20';
$data = json_decode(file_get_contents($url), true);

echo count($data['pros']) . " restaurants à Nouméa\n";
foreach ($data['pros'] as $p) {
    echo "- {$p['name']} · " . ($p['phone'] ?? '—') . "\n";
}

🗺️ Embed widgets

Intégrer notre carte interactive ou notre annuaire dans votre site en 1 ligne :

Carte interactive

<iframe src="https://caledohub.com/carte.html"
        width="100%" height="600"
        style="border:0;border-radius:12px"
        loading="lazy"
        title="Carte pros NC"></iframe>

Recherche live

<iframe src="https://caledohub.com/recherche.html?q=plombier"
        width="100%" height="500"
        style="border:0;border-radius:12px"
        loading="lazy"
        title="Recherche pros NC"></iframe>

Stats live

<iframe src="https://caledohub.com/stats.html"
        width="100%" height="400"
        style="border:0;border-radius:12px"
        loading="lazy"
        title="Stats live NC"></iframe>

✅ Tous les embeds respectent le branding caledohub (gratuit). Pour version "white-label" sans branding : contactez-nous.

📋 Schéma de réponse standard

Toutes les réponses suivent un format unifié { meta, [data] } :

{
  "meta": {
    "api": "caledohub-pros-v1",
    "updated_at": "2026-05-15T08:00:00+00:00",
    "count": 50,
    "limit": 100,
    "filters": {"commune": "Nouméa"},
    "documentation": "https://caledohub.com/a-propos.html",
    "license": "CC-BY 4.0 — citez caledohub.com"
  },
  "pros": [
    {
      "id": "024fmm2oe5DARTECkuyH",
      "name": "Garage Bertuzzi Umberto",
      "category": "auto-moto",
      "subcategory": "Garage/Mécanique générale",
      "commune": "Nouméa",
      "phone": "+687 28.45.12",
      "website": "",
      "tier": "free",
      "verified": false,
      "address": "249 rue Armand Ohlen",
      "isDemo": false
    }
  ]
}

⚖️ Licence & conditions CC-BY 4.0

Toute donnée renvoyée par l'API est sous licence Creative Commons Attribution 4.0 International (CC-BY 4.0).

✅ Vous pouvez :

Réutiliser librement (commercial ou non)
Modifier, transformer, créer des œuvres dérivées
Distribuer publiquement

📋 Condition unique : créditez clairement caledohub.com dans toute réutilisation publique (footer, mentions légales, source data).

⚠️ Données personnelles : les pros référencés ont parfois des coordonnées (téléphone, email). Pas de mass-scraping ou démarchage non sollicité (RGPD respecté). Pour de gros volumes, contactez-nous : contact@deep-com.com.

📞 Support développeurs

Une question, un bug, une demande d'évolution API ? Plusieurs canaux :

📧 Email : contact@deep-com.com
📝 OpenAPI spec : /api/openapi.json
🐛 Bug report : avec URL exacte, query params, réponse reçue, comportement attendu
💡 Feature request : décrivez votre use case

Réponse sous 24-72h ouvrées. Communauté tech NC active : groupe Slack "Tech NC", meetups Innovation Lab.

🚀 Construisez quelque chose de cool ?

Partagez votre intégration et nous la mettrons en avant sur la page partenaires ! Ça donne aussi accès à des features bêta avant tout le monde.

📨 Présenter mon projet

👨‍💻 Portail développeurs