L'API REST v1 permet à vos propres systèmes de gérer les codes, lire les statistiques de scans, téléverser des fichiers hébergés, enregistrer des conversions et gérer les endpoints webhook. L'accès API dépend de votre offre.

Créer une clé

  1. Ouvrez Clés API dans le tableau de bord et créez une clé.
  2. Choisissez la portée. Les clés Lecture ne peuvent appeler que les endpoints GET. Les clés Complètes peuvent créer, mettre à jour et supprimer.
  3. Copiez la clé quand elle est affichée. Le secret complet est affiché une fois à la création et n'est jamais stocké ni réaffiché.
Les clés API, avec la portée et l'heure de dernière utilisation de chaque clé
Les clés API, avec la portée et l'heure de dernière utilisation de chaque clé

Appeler l'API

Envoyez la clé en en-tête d'autorisation :

bash
curl https://dynamihost.com/api/v1/codes \
  -H "Authorization: Bearer <redacted>"

Créer un code :

bash
curl -X POST https://dynamihost.com/api/v1/codes \
  -H "Authorization: Bearer <redacted>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Counter menu", "type": "url", "destination": "https://example.com/menu"}'

Règles qui font gagner du temps de débogage

  • Utilisez la portée la plus étroite qui fonctionne. Un travail de rapport a besoin d'une clé de lecture, pas d'une clé complète.
  • Une clé par système. Révoquer une clé divulguée ne devrait pas mettre hors service trois intégrations.
  • Respectez les limites de débit. Les réponses incluent l'état de la limite ; ralentissez au lieu de réessayer en boucle serrée.
  • Faites tourner les clés comme les mots de passe. Créez la nouvelle clé, déployez-la, confirmez que les appels réussissent, puis révoquez l'ancienne.