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

Les mêmes opérations se pilotent aussi depuis un assistant IA.

Découvrir le serveur MCP Printags

SDK et CLI Printags pour l'API

// Créer une commande de carte

POST https://api.printags.com/v2/accounts/@me/orders
Authorization: Bearer sk_test_...
Idempotency-Key: order-2026-001

{
  "isDraft": true,
  "reference": "Order-2026-001",
  "shipTo": {
    "name": "Jean Dupont",
    "phone": "+33612345678",
    "email": "[email protected]",
    "address": {
      "addressLine1": "12 rue de la Paix",
      "city": "Paris",
      "postcode": "75002",
      "countryCode": "FR"
    }
  },
  "items": [{
    "productId": "ntag213_pvccard_white",
    "quantity": 10,
    "printingVisuals": ["<fileId>"],
    "nfc": { "type": "uri", "content": "https://example.com/jean" }
  }]
}

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/v2/accounts/{accountId}/ordersCréer une commande, en brouillon ou ferme (en-tête Idempotency-Key accepté)

GET/v2/accounts/{accountId}/orders/{orderId}Lire une commande

GET/v2/accounts/{accountId}/ordersLister les commandes, avec pagination

POST/v2/accounts/{accountId}/filesDéposer un fichier de visuel

GET/v2/productsCatalogue des produits

POST/v2/shipping/ratesPrix de livraison pour une destination

POST/v2/accounts/{accountId}/orders/{orderId}/validateValider une commande en brouillon

GET/v2/statusesStatuts des commandes

Webhooks

Notifications en temps réel

Recevez des notifications automatiques quand une commande change. Configurez vos webhooks depuis le tableau de bord.

order.created

Commande créée

order.updated

Commande mise à jour

order.shipped

Commande expédiée

order.delivered

Livraison confirmée

Sandbox & sécurité

Testez en toute sécurité

Les clés de test (sk_test_...) créent des commandes de test, ni débitées ni fabriquées. Utilisez l'API de production avec une clé de test, ou sandbox-api.printags.com, qui n'accepte que des clés de test.

Les commandes de test ne sont jamais débitées ni fabriquées
Clés API séparées (test / production)
HTTPS obligatoire sur tous les endpoints
Limites de débit annoncées dans les en-têtes standard RateLimit
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.

Votre boutique tourne sur WooCommerce, Shopify ou PrestaShop ? Pas besoin de développer.

L'extension WooCommerce, l'app Shopify et le module PrestaShop

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.

Des SDK sont-ils disponibles ?

Oui : le paquet npm printags (SDK et ligne de commande pour Node.js 18 ou supérieur, licence MIT). L'API est aussi une API REST classique décrite par un document OpenAPI : n'importe quel langage peut l'appeler. Voir la page SDK et CLI.

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, facturés automatiquement 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.

Y a-t-il des limites de débit ?

Les routes documentées autorisent 1200 requêtes par minute et par clé d'API. Chaque réponse porte les en-têtes RateLimit, et une réponse 429 porte Retry-After.

Comment fonctionne le versionnement de l'API ?

La version courante est /v2. La version 1 (/v1) est dépréciée depuis le 25 octobre 2026 et sera retirée le 4 janvier 2027 : chaque réponse documentée de la version 1 porte les en-têtes Deprecation et Sunset et un lien Link vers son équivalent en version 2.

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