Développez avec l’API AlwaysCompleted

Intégrez AlwaysCompleted à votre système côté serveur pour récupérer les services, passer des commandes et suivre leur avancement. Ce guide vous accompagne depuis votre première requête en lecture seule jusqu’aux vérifications nécessaires à la création de commandes. Gardez la documentation de l’API ouverte pour consulter les listes complètes de paramètres et les exemples de réponses.

Préparer la connexion

1. Créez un compte et utilisez la clé API de ce compte dans votre configuration côté serveur.
2. Consultez le catalogue des services ainsi que les conditions des services que vous prévoyez de proposer. Les exigences, les options disponibles et les limites de commande dépendent du service sélectionné.
3. Envoyez les requêtes depuis votre propre serveur via HTTPS. Laissez la vérification habituelle des certificats TLS activée.
4. Conservez la clé API de manière sécurisée sur votre serveur. Ne l’exposez pas dans des pages publiques, du JavaScript exécuté dans le navigateur, des captures d’écran ou des exemples de code partagés.

Effectuer une première requête en lecture seule

Le point d’accès documenté accepte les requêtes POST et renvoie du JSON. L’exemple officiel utilise des paramètres de formulaire au format application/x-www-form-urlencoded. Chaque action comprend votre clé API et un nom d’action.

POST https://alwayscompleted.com/api/v2

key=YOUR_API_KEY&action=services

Remplacez la valeur d’exemple uniquement dans votre configuration côté serveur. L’action services lit le catalogue ; elle ne crée pas de commande. Utilisez sa réponse pour identifier les services et examiner les champs disponibles avant de construire votre formulaire de commande.

Utiliser des informations à jour sur les services et le compte

La liste des services décrit, pour chacun, son nom, son type, sa catégorie, son tarif, ses quantités minimale et maximale, ainsi que les indicateurs de refill et d’annulation. Associez l’identifiant du service choisi à sa description et à ses exigences actuelles. Préparez les commandes à partir des données renvoyées, sans recopier les identifiants ou les prix donnés à titre d’exemple dans la documentation.

Utilisez action=balance pour consulter le solde de votre compte et sa devise. Les montants présentés dans les exemples de la documentation sont des données de démonstration. Votre application doit afficher la réponse réelle et traiter les erreurs avant de poursuivre.

Gérer les changements d’un catalogue en cache

Lorsque vous actualisez un catalogue en cache, recherchez les identifiants de services supprimés et les changements de tarifs ou de limites de quantité avant de rendre les options enregistrées à nouveau disponibles. Si un identifiant sélectionné est absent de la réponse actuelle, suspendez cette commande pour vérification au lieu de choisir un service au nom similaire. Si un tarif, un type ou une limite de quantité change, mettez votre formulaire à jour et validez de nouveau la sélection avant d’envoyer action=add. Enregistrez les détails du service vérifiés avec votre commande locale afin de pouvoir relier les questions ultérieures à la sélection effectivement contrôlée par votre application.

Vérifier chaque création de commande

Pour créer une commande, envoyez action=add avec l’identifiant du service sélectionné et les champs requis pour ce type de service. Une commande de type Default utilise link et quantity ; les autres types ont des paramètres différents. Consultez la section correspondante de la documentation avant l’envoi.

Une fois la commande créée, enregistrez l’identifiant renvoyé avec votre propre enregistrement de commande. En cas d’expiration du délai d’une requête ou de réponse ambiguë, vérifiez le résultat avant de l’envoyer à nouveau. Répéter une requête add sans vérification risque de créer un doublon involontaire. N’utilisez jamais la création d’une commande comme test automatique de connexion.

Suivre les commandes et les demandes complémentaires prises en charge

Utilisez action=status avec order pour une seule commande, ou orders avec des identifiants séparés par des virgules pour un lot de 100 au maximum. La réponse documentée comprend status, charge, start_count, remains et currency. Examinez chaque résultat : un lot peut contenir une erreur pour un identifiant particulier.

Le refill et l’annulation sont des demandes soumises à la disponibilité et aux conditions du service choisi. Utilisez action=refill pour demander un refill, action=refill_status pour en suivre le traitement et action=cancel pour demander une annulation. Les variantes par lot documentées acceptent jusqu’à 100 identifiants. L’envoi d’une demande ne garantit pas l’acceptation du refill ou de l’annulation.

Poursuivre votre intégration

Consultez la documentation complète de l’API pour connaître les paramètres exacts des actions et leurs exemples. Si vous développez un système de services destiné à vos clients, consultez AlwaysCompleted pour les revendeurs. Lisez les Conditions d’utilisation ainsi que la description de chaque service avant d’accepter les commandes de vos clients.