API DeCA

API pour émettre, rectifier, consulter et télécharger des documents espagnols de contrôle administratif du transport de marchandises. Contactez le support SERTEC PESAGE pour obtenir un jeton. Les jetons sk_test_ utilisent le développement et les sk_live_ la production, avec des données séparées. La restriction par IP est facultative.

Chaque identifiant permet de consulter et télécharger ses documents pendant les 24 heures suivant leur création. Le téléchargement par QR a une durée de validité indépendante. Les rectifications conservent le document original.

La suppression logique n'est autorisée que durant les 2 premières heures pour corriger des erreurs de génération. L'intégration doit confirmer que le document n'a été ni remis au transporteur ni utilisé pour le transport. Le fichier et la traçabilité sont conservés, mais l'accès est bloqué.

Vous pouvez demander un jeton sk_demo_ sans compte ni organisation enregistrée. Il dure 24 heures à partir de son émission et fonctionne uniquement depuis l’IP publique qui l’a demandé. Un changement de réseau ou d’IP nécessite un autre jeton. Utilisez uniquement des données fictives. Chaque page du PDF affiche SANS VALIDITÉ à côté du logo et un filigrane diagonal DEMO. Ces documents ne sont valables ni pour transporter des marchandises ni pour un usage administratif. La démo ajoute demo: true, expires_at, qr_url (alias de url) et pdf_url (alias de pdf_download_url). document_locale est la langue choisie lors de la demande du jeton (es par défaut). Les données et PDF temporaires sont distincts de l’archive réelle et ne sont pas chiffrés comme les documents réels. La démo accepte des corps de requête jusqu’à 32 KiB et dix documents par session. L’émission de jetons permet trois par minute et dix par heure depuis la même IP ; la création de documents permet cinq par minute et vingt par heure depuis la même IP. Les limites partagées par réseau, région et charge globale peuvent s’appliquer plus tôt. Ces valeurs correspondent à la configuration par défaut.

Schémas de sécurité
bearerAuth
Jeton d'intégration fourni par le support SERTEC PESAGE. Envoyez-le dans Authorization: Bearer, exclusivement via HTTPS. sk_test_ sélectionne le développement et sk_live_ la production. Si le jeton possède une liste d'IP autorisées, la requête doit provenir de l'une d'elles ; une liste vide autorise toute IP. N'envoyez pas le jeton dans l'URL et ne l'exposez pas dans les applications clientes. Vous pouvez demander un jeton sk_demo_ sans compte ni organisation enregistrée. Il dure 24 heures à partir de son émission et fonctionne uniquement depuis l’IP publique qui l’a demandé. Un changement de réseau ou d’IP nécessite un autre jeton. Utilisez uniquement des données fictives. Chaque page du PDF affiche SANS VALIDITÉ à côté du logo et un filigrane diagonal DEMO. Ces documents ne sont valables ni pour transporter des marchandises ni pour un usage administratif.
http
qrSecret
Secret opaque du lien QR ; copiez exactement la valeur renvoyée dans url.
apiKey