Consulter un forfait tarifaire enregistré
Consultez les lignes tarifaires enregistrées pour votre compte API après avoir parcouru les numéros de téléphone disponibles. Utilisez le champ uuid de l’option tarifaire figurant dans la liste price du numéro sélectionné, et non le numéro lui-même, l’identifiant du préfixe ou celui de la zone. Conservez l’association entre le numéro sélectionné et l’option tarifaire.
Cette consultation des tarifs enregistrés est fournie à des fins de compatibilité. Elle ne met à jour ni la disponibilité ni les prix, ne réserve aucun numéro, ne passe aucune commande et ne garantit pas le montant d’un achat futur. Avant de commander, examinez l’option tarifaire renvoyée par une nouvelle recherche de numéros.
Requête
Utilisez votre compte API activé via HTTPS depuis une adresse IP autorisée. Définissez PRICE_ID sur l’identifiant exact de l’option tarifaire que vous avez reçu. La méthode lit un seul argument de chemin, sans corps de requête ni paramètres de date ou de pagination.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Cette consultation doit être effectuée par le compte qui a obtenu l’option tarifaire. Ne créez pas d’identifiant, n’utilisez pas de numéro de ligne de base de données et ne remplacez pas la sélection par celle d’un autre compte. Cette ancienne méthode recherche uniquement une correspondance avec l’identifiant visible du tarif.
Réponse
L’exemple fictif suivant présente uniquement certains champs destinés aux clients. Les réponses réelles renvoient les lignes enregistrées complètes et peuvent inclure des métadonnées supplémentaires sur le compte, le fournisseur et la tarification interne. Conservez la réponse complète sur votre serveur et n’exposez que les valeurs destinées aux clients dont votre application a besoin.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response est une liste, même lorsqu’une seule ligne est renvoyée. status.results indique le nombre de lignes renvoyées. Les valeurs numériques de la base de données peuvent être des chaînes de caractères. Le point de terminaison n’ajoute pas de champ de devise et ne convertit pas les devises ; confirmez la devise de facturation du compte plutôt que de la déduire de cet exemple.
Champs tarifaires
| Champ | Signification |
|---|---|
| visible_uuid | Identifiant visible de l’option tarifaire enregistrée. Utilisez l’identifiant d’origine de l’option pour établir la correspondance avec la consultation. |
| setup_price | Frais de mise en service uniques enregistrés pour cette option. |
| monthly_price | Tarif mensuel récurrent enregistré. |
| per_minute, free_minutes | Tarif à la minute des appels entrants et nombre de minutes incluses enregistrés. Ces valeurs ne constituent pas un devis pour les appels sortants ni pour tous les suppléments possibles. |
| channels | Nombre de canaux enregistré pour cette option ; il ne s’agit pas d’une vérification en temps réel de la capacité ou de l’enregistrement. |
| yearly_price | Un champ supplémentaire contenant un tarif annuel enregistré peut être présent. Ne déduisez pas qu’un tarif mensuel non nul associé à un champ annuel égal à zéro correspond à un forfait annuel gratuit. |
Gérer plusieurs lignes correspondantes
Une consultation peut renvoyer plusieurs lignes enregistrées. La méthode ne garantit aucun ordre, ne sélectionne pas la ligne la plus récente et ne propose aucun filtre par numéro ou préfixe. Ne choisissez pas automatiquement la première ou la dernière ligne sans le signaler. Comparez le contexte renvoyé avec le numéro et l’option tarifaire sélectionnés à l’origine ; si ce contexte reste ambigu ou obsolète, relancez la recherche de numéros au lieu de considérer cette réponse comme un devis de commande.
Le processus de vérification des commandes du portail effectue des contrôles supplémentaires de sélection et de validité. Ne supposez pas que cette ancienne méthode de consultation réalise ces contrôles ou accepte tous les identifiants acceptés par le portail.
Réponses vides et erreurs
Si aucune ligne enregistrée ne correspond, le gestionnaire actuel ne produit aucun résultat JSON ni aucune réponse explicite indiquant qu’aucun résultat n’a été trouvé. Un corps vide ne signifie ni un prix nul, ni un forfait disponible, ni une consultation dont la réussite est confirmée. Vérifiez à la fois la réponse HTTP et la structure JSON ; ne passez pas de commande à partir de données tarifaires absentes ou impossibles à analyser.
L’authentification, les restrictions sur l’adresse IP source et les défaillances de la base de données peuvent également empêcher l’obtention d’une réponse exploitable. Aucune enveloppe d’erreur propre au gestionnaire n’est prévue pour une exception de base de données. Renouvelez votre sélection ou contactez l’assistance lorsqu’une consultation authentifiée reste indisponible.
Effets et limites
La consultation examinée exécute une requête de lecture et ne comporte aucun débit, achat, réservation ou actualisation des tarifs du fournisseur. La lecture des tarifs enregistrés ne confirme ni le stock actuel, ni l’approbation réglementaire, ni l’autorisation d’achat du compte, ni la facturation définitive.