Documentation

Documentation technique et guides d'intégration

Tout ce dont vous avez besoin pour intégrer Valqor dans votre stack.

Premiers pas

Créez votre premier lien de marque, configurez un domaine personnalisé et explorez le tableau de bord.

Inscrivez-vous et créez votre espace de travail
Ajoutez un domaine personnalisé dans Tableau de bord → Domaines
Créez votre premier lien avec un slug de marque
Consultez l'analytique en temps réel dans votre tableau de bord

Référence API

API REST pour les liens, domaines, analytics et gestion des clés API avec permissions scopées.

Authentification

Générez une clé API dans Tableau de bord → Clés API. Ajoutez-la comme jeton Bearer :

Authorization: Bearer vq_your_key_here

Intégrations

Connectez Valqor à votre CRM, pipelines CI/CD, plateformes marketing et outils d'analytics.

Webhooks — Notifications d'événements en temps réel (HTTPS uniquement)
Import/export CSV — Gestion des liens en masse
Suivi des conversions — Attribution par pixel
GA4 — Balisage automatique des paramètres UTM

REST API

Endpoints de l'API

URL de base : https://valqor.app

POST/api/links

Crée un nouveau lien de marque

Exemple

curl -X POST https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "slug": "launch",
    "destination": "https://example.com/product",
    "tags": ["marketing", "launch-2025"]
  }'

GET/api/links

Liste tous les liens de votre espace de travail

Exemple

curl https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..."

PATCH/api/links/:id

Met à jour un lien existant

Exemple

curl -X PATCH https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{ "destination": "https://example.com/new-page" }'

DELETE/api/links/:id

Supprime définitivement un lien

Exemple

curl -X DELETE https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..."

GET/api/analytics

Récupère l'analytique de vos liens

Exemple

curl "https://valqor.app/api/analytics?period=30d" \
  -H "Authorization: Bearer vq_..."

GET/api/domains

Liste les domaines personnalisés configurés

Exemple

curl https://valqor.app/api/domains \
  -H "Authorization: Bearer vq_..."

Limites

Limitation de débit

Les limites de débit de l'API s'appliquent par clé API avec une fenêtre glissante.

Free60 req/min

Pro600 req/min

Business6 000 req/min

Conventions

Format de réponse

Succès

{
  "item": { "id": "lnk_abc123", "slug": "launch", ... }
}

Erreur

{
  "error": "Slug is already taken",
  "code": "SLUG_COLLISION"
}

Aller au tableau de bord