Import et export en masse de liens courts

Quand vous avez des dizaines ou des milliers d’URL à raccourcir, envoyez-les dans un seul fichier CSV au lieu de créer chaque lien à la main. Chaque ligne devient un lien court normal que vous pouvez modifier, partager et suivre comme les autres.

Note

La création en masse dépend de votre forfait. Chaque ligne créée coûte autant qu’une création à la main, et l’import ou l’export n’ajoute aucun coût. Consultez la page des crédits pour plus de détails. Crédits des fonctionnalités

Importer des liens courts depuis un fichier CSV

1. Ouvrez le Raccourcisseur d’URL dans le tableau de bord et choisissez Import en masse.

2. Téléchargez le modèle CSV, remplissez une ligne par lien et enregistrez-le en CSV.

3. Envoyez le fichier et choisissez les valeurs par défaut pour les lignes qui laissent une colonne vide, comme le modèle ou l’étiquette.

4. Vérifiez le fichier. Posty5 lit chaque ligne sans rien créer et liste les lignes qui échoueraient.

5. Lancez l’import. Vous pouvez quitter la page, une notification vous prévient quand il est terminé.

Les colonnes du fichier

Seule la colonne url est obligatoire. Les noms de colonnes ne tiennent pas compte de la casse, et une colonne inconnue de Posty5 est ignorée et signalée à l’étape de vérification.

Column
url	L’adresse de destination. Obligatoire. baseUrl est aussi accepté comme autre nom.
name	Un nom pour votre propre liste. S’il est vide, Posty5 le remplit avec le titre de la page en arrière-plan.
customId	Votre propre fin pour le lien court, si votre forfait autorise les ID personnalisés. Il ne doit pas être déjà utilisé, y compris par une ligne précédente du même fichier.
tag	Une étiquette pour regrouper et filtrer les liens plus tard.
refId	Votre propre référence, par exemple un code produit de votre système.
templateId	Le modèle de code QR de cette ligne. Il remplace la valeur par défaut choisie.

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

Enregistrez le fichier en CSV UTF-8 avec des virgules et une ligne d’en-tête. Les valeurs contenant des virgules vont entre guillemets doubles, comme le font les tableurs d’eux-mêmes.

Vérification du fichier

La vérification applique les mêmes règles que la création d’un lien à la main et affiche chaque ligne en échec avec son numéro, en comptant depuis la première ligne sous l’en-tête. Une ligne échoue quand

• l’URL manque, n’est pas une adresse web valide ou dépasse 2,048 caractères
• l’URL est bloquée car dangereuse
• un nom, une étiquette ou une référence dépasse 255 caractères
• l’ID personnalisé n’est pas autorisé par votre forfait, est invalide ou déjà utilisé
• le modèle n’existe pas ou ne vous appartient pas

Limites

• Un fichier contient jusqu’à 5,000 lignes et 2 Mo.
• Vous pouvez créer jusqu’à 20,000 lignes en masse par jour (UTC), en comptant ensemble tous les imports et appels API.
• Un seul import s’exécute à la fois, et jusqu’à trois autres peuvent attendre.
• Si vos crédits s’épuisent pendant un import, cette ligne et toutes les suivantes échouent avec « Crédits insuffisants », et les liens déjà créés restent.

Progression

La page d’import indique combien de lignes ont été traitées, créées et en échec, et se met à jour seule. Vous pouvez annuler un import en cours ; les liens créés avant l’annulation restent.

Les titres de page et les liens profonds d’applications sont récupérés en arrière-plan après la création de chaque lien, un lien peut donc afficher son hôte comme nom pendant un court moment.

Le fichier de résultats

Une fois l’import terminé, téléchargez son fichier de résultats. Il contient une ligne par ligne de votre fichier.

Column
row	Le numéro de ligne dans votre fichier, en comptant depuis la première ligne sous l’en-tête.
status	created, failed, skipped, ou notProcessed si l’import s’est arrêté avant d’atteindre la ligne.
id, shortUrl	L’ID et l’adresse courte du nouveau lien.
errors	Pourquoi la ligne a échoué.

Un second fichier contient uniquement les lignes en échec avec vos valeurs d’origine, pour les corriger et renvoyer ce fichier.

Imports précédents

Tâches en masse liste vos imports récents avec leur statut et leurs compteurs. Ouvrez-en un pour voir sa progression ou retélécharger ses fichiers.

Attention

Les fichiers envoyés et les fichiers de résultats sont conservés 7 jours, et l’historique d’un import 30 jours. Téléchargez ce dont vous avez besoin avant. Les liens eux-mêmes ne sont jamais supprimés.

Création en masse via l’API

Les développeurs peuvent envoyer jusqu’à 100 lignes en une requête et recevoir aussitôt un résultat par ligne, ou soumettre un fichier de jusqu’à 5,000 lignes comme tâche et l’interroger. Les mêmes limites et vérifications s’appliquent, et la requête respecte l’en-tête Idempotency-Key pour qu’une nouvelle tentative ne crée pas les liens deux fois. Les routes sont documentées dans la référence de l’API (Swagger).

• POST /api/short-link/bulk
• POST /api/link-bulk-jobs
• GET /api/short-link/export

Exportez vos liens

Dans la liste des liens courts, choisissez Exporter en CSV ou Exporter en JSON pour télécharger vos liens avec leurs compteurs de visites.

• L’export utilise les filtres appliqués à la liste, filtrez donc d’abord pour n’en exporter qu’une partie.
• Un export contient jusqu’à 50,000 lignes, les plus récentes en premier. Une liste plus longue est coupée à ce point, et le fichier l’indique dans sa dernière ligne (CSV) ou son champ truncated (JSON).
• Une cellule qui commence par = + - ou @ reçoit une apostrophe initiale dans le CSV, afin que le tableur l’affiche comme du texte au lieu de l’exécuter comme une formule.