Supprimer une URL

Supprime un lien court du portail BulkGate. Une fois supprimé, le lien cesse de rediriger, y compris dans les messages déjà envoyés avec ce lien.

URL de l'API

URL à laquelle envoyer les requêtes HTTP :

https://portal.bulkgate.com/api/1.0/shortener/remove

Note

Si la requête n'atteint pas sa destination, renvoyez-la sur le serveur de secours backup1.bulkgate.com.

Méthodes HTTP prises en charge

POST - application/json

POST /api/1.0/shortener/remove HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Note

L'API est soumise à un quota de 20 requêtes par minute.

Tableau des paramètres

NOM DU PARAMÈTRE	VALEUR	OBLIGATOIRE	VALEUR PAR DÉFAUT
application_id	Application ID	Oui	-
application_token	Token d'authentification de l'application	Oui	-
short_url	URL raccourcie à supprimer	Oui	-

Exemple de requête

POST /api/1.0/shortener/remove HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "short_url": "http://ur7.wf/W/1" }

Réponse

En cas de succès :

{ "data": { "short_url": "http://ur7.wf/W" } }

En cas d'erreur :

{ "type": "url_not_found", "code": 400, "error": "Url not found", "detail": null }

{ "type": "the_per_minute_quota_has_been_exceeded", "code": 400, "error": "The per minute quota has been exceeded", "detail": null }

Où :

type et error (description de l'erreur) figurent dans le tableau des types d'erreurs
code est le code d'erreur HTTP
detail contient des informations complémentaires sur l'erreur

Types d'erreurs de l'API Shortener

En plus des types généraux, l'API Shortener renvoie ses propres types :

TYPE	QUAND CELA SE PRODUIT
`url_not_found`	`short_url` n'existe pas dans le compte.
`the_per_minute_quota_has_been_exceeded`	Le quota de 20 requêtes par minute est épuisé.

Cette page vous a-t-elle été utile ?

Demander à l'IA Copié