Pour les développeurs

Intégration API

Automatisez la production de cartes depuis votre système. REST API, webhooks, documentation complète.

Accéder à la documentation Parler à un ingénieur

Intégration rapide

Simple à intégrer

Une requête HTTP suffit pour déclencher l'impression, l'encodage NFC et l'expédition d'une carte. Webhooks pour le suivi en temps réel.

REST API avec authentification par clé API
Webhooks pour les mises à jour de statut en temps réel
Sandbox complète pour tester sans frais
Documentation OpenAPI (Swagger) complète
Réponses JSON standardisées et paginées
Idempotence sur les requêtes de création

// Créer une commande de carte

POST https://api.printags.com/v1/orders

{
  "card_type": "ntag213",
  "design": {
    "template_id": "tpl_abc123",
    "variables": {
      "name": "Jean Dupont",
      "title": "Directeur technique",
      "photo": "https://..."
    }
  },
  "nfc": {
    "url": "https://example.com/jean"
  },
  "shipping": {
    "name": "Jean Dupont",
    "address": "12 rue de la Paix",
    "city": "Paris",
    "country": "FR"
  }
}

Architecture

Architecture d'intégration

Votre système communique avec l'API Printags. Nous gérons tout le reste.

Votre système

ERP, CRM, e-commerce, SaaS

API RESTWebhooks

Printags

Impression + encodage + expédition

Référence API

Endpoints principaux

POST/v1/ordersCréer une commande

GET/v1/orders/:idStatut d'une commande

GET/v1/orders/:id/trackingSuivi d'expédition

POST/v1/designsUploader un design

GET/v1/templatesLister les templates

POST/v1/webhooksConfigurer un webhook

GET/v1/cards/:idDétails d'une carte

GET/v1/billing/usageConsommation mensuelle

Webhooks

Notifications en temps réel

Recevez des notifications automatiques à chaque changement de statut. Configurez vos webhooks via l'API ou le dashboard.

order.created

Commande reçue et validée

order.printing

Impression en cours

order.encoding

Encodage NFC en cours

order.quality_check

Contrôle qualité passé

order.shipped

Colis expédié, numéro de suivi disponible

order.delivered

Livraison confirmée

Sandbox & sécurité

Testez en toute sécurité

L'environnement sandbox réplique l'API de production. Testez votre intégration sans frais et sans risque.

Sandbox identique à la production
Clés API séparées (test / production)
HTTPS obligatoire sur tous les endpoints
Rate limiting configurable
Logs et historique de toutes les requêtes

Scénarios d'intégration

Comment nos intégrateurs utilisent l'API

E-commerce

Un client commande une carte sur votre boutique. L'API déclenche automatiquement la production et l'expédition.

SaaS / Plateforme

Votre plateforme gère des membres. À chaque inscription, une carte est automatiquement imprimée et envoyée.

RH / Corporate

Nouvel employé = badge automatique. L'API s'intègre à votre SIRH pour déclencher la production.

IoT / Bornes

Nouvel abonné à votre réseau de bornes = badge NFC imprimé et expédié automatiquement via l'API.

Événementiel

Inscriptions en ligne = badges personnalisés produits et envoyés aux participants avant l'événement.

Programme fidélité

Nouveau membre de votre programme = carte fidélité NFC imprimée avec données variables et encodage.

Questions fréquentes

FAQ — Intégration API

Combien de temps prend l'intégration ?

La plupart de nos intégrateurs sont opérationnels en moins d'une journée. La documentation est complète, avec des exemples de code dans plusieurs langages. Un environnement sandbox est disponible immédiatement.

Y a-t-il des SDKs disponibles ?

L'API est une REST API standard (JSON over HTTPS). Elle est compatible avec tous les langages et frameworks. Nous fournissons des exemples de code et des collections Postman pour démarrer rapidement.

L'API est-elle disponible 24/7 ?

Oui, l'API est disponible 24h/24, 7j/7. Nous garantissons un SLA de 99,9% de disponibilité. Un statut en temps réel est disponible sur notre page de statut.

Comment fonctionne la facturation ?

Abonnement mensuel + coût unitaire par carte. L'API endpoint /v1/billing/usage vous permet de suivre votre consommation en temps réel. Facturation automatique en fin de mois.

Les données transmises sont-elles sécurisées ?

Oui. HTTPS obligatoire sur tous les endpoints. Les données personnelles (photos, noms) sont chiffrées au repos et supprimées après production. Conformité RGPD.

Puis-je limiter les appels API de mes utilisateurs ?

Oui, le rate limiting est configurable. Par défaut, 100 requêtes par minute. Ajustable selon votre plan.

Prêt à intégrer ?

Créez votre compte et accédez à la sandbox en 2 minutes. Documentation complète disponible.

Créer mon compte intégrateur Documentation API