Référence de l’API
Tarifs
Prix actuels par envoi, pour qu’un intégrateur puisse estimer un coût avant d’envoyer.
/v1/pricingPrix actuels par envoi, en cents CAD
Réponses
200Prix actuels. Tous les montants sont en cents CAD.
Champ Type Description message_cost_centsinteger Facturé par segment SMS, compté selon le découpage du corps du message par l’opérateur : les guillemets typographiques, les tirets et les points de suspension sont convertis intelligemment en GSM-7 (160 caractères, puis 153 par segment) ; les émojis et la plupart des lettres accentuées imposent des segments Unicode (70, puis 67). Le montant facturé est ajusté au nombre de segments compté par l’opérateur après l’envoi. Les corps de plus de 10 segments sont refusés avec 422 MESSAGE_TOO_LONG avant toute facturation.
verification_upcharge_centsinteger Ajouté une seule fois par vérification, en plus du coût de la partie SMS du code NPU lui-même.
verification_cost_centsinteger Coût d’une vérification typique en un seul segment : message_cost_cents + verification_upcharge_cents. Un app_name long ou hors GSM peut faire passer le code de vérification (NPU) à deux segments et augmenter ce montant ; les frais sont ajustés au nombre de segments compté par l’opérateur une fois le code accepté.
phone_number_upfront_cost_centsinteger Le loyer du premier mois d’un numéro local, facturé lors de son provisionnement.
phone_number_monthly_cost_centsinteger Loyer mensuel récurrent d’un numéro local.
phone_number_activation_fee_centsinteger Frais d’activation uniques d’un numéro local, facturés avec le premier mois. Non remboursés à la libération. Le premier débit d’un numéro local correspond à phone_number_upfront_cost_cents + phone_number_activation_fee_cents. Les frais d’activation d’un numéro sans frais lui sont propres : phone_number_tollfree_activation_fee_cents, qui figurent aussi dans son résultat de recherche (activation_fee_cents) ; ils sont de 0 $ par défaut.
phone_number_tollfree_monthly_cost_centsinteger Loyer mensuel récurrent d’un numéro sans frais (833, 844, 855, 866, 877, 888). Son premier débit, lors de son provisionnement, correspond à upfront_cost_cents dans son résultat de recherche plus phone_number_tollfree_activation_fee_cents.
phone_number_tollfree_activation_fee_centsinteger Frais d’activation uniques d’un numéro sans frais, facturés avec son premier mois et non remboursés à la libération. 0 signifie aucuns frais.
tollfree_verification_fee_centsinteger Frais uniques par demande de vérification sans frais, payés à sa première soumission (POST /v1/toll-free-verifications/{id}/submit) ; la renvoyer après CHANGES_REQUESTED ou REJECTED est gratuit. Un numéro sans frais ne peut pas envoyer de SMS tant que sa vérification n’est pas approuvée.
inbound_message_cost_centsinteger Facturé par segment SMS de chaque SMS entrant reçu sur un numéro provisionné, selon le nombre de segments établi par l’opérateur. Le trafic de mots-clés exigé par l’opérateur (STOP, START, HELP) n’est pas facturé.
email_price_millicentsinteger Facturé par destinataire de courriel accepté (to, cc et bcc comptent chacun), en millicents CAD : des millièmes de cent, donc 250 correspond à 0,0025 $, soit 2,50 $ par 1 000. Les premiers email_attachment_included_bytes de pièces jointes par destinataire sont inclus. Les envois en mode test sont gratuits. Absent tant que l’envoi de courriels n’est pas offert.
email_attachment_included_bytesinteger Octets de pièces jointes inclus dans email_price_millicents, par destinataire.
email_attachment_price_millicents_per_mbinteger Facturé par destinataire pour chaque Mo entamé (1 048 576 octets) de pièces jointes au-delà des octets inclus, en millicents CAD. Une pièce jointe de 10 Mio envoyée à un destinataire coûte, aux tarifs par défaut, 250 + 8 × 200 = 1 850 millicents (0,0185 $).
email_attachment_max_bytesinteger Taille maximale des pièces jointes par courriel, en octets, au total et par fichier (413 EMAIL_ATTACHMENT_TOO_LARGE au-delà). Au plus 10 fichiers par courriel.
email_inbound_price_millicentsinteger Facturé par courriel reçu, en millicents CAD : des millièmes de cent, donc 250 correspond à 0,0025 $. Couvre les premiers email_inbound_included_bytes du message. Facturé à la réception, quel que soit le solde ; les courriels rejetés pour cause de virus ou de dépassement du plafond quotidien ne sont pas facturés. Absent tant que l’envoi de courriels n’est pas offert.
email_inbound_included_bytesinteger Octets d’un message reçu (message brut, en-têtes et pièces jointes encodées compris) couverts par email_inbound_price_millicents.
email_inbound_price_millicents_per_mbinteger Facturé pour chaque Mo entamé (1 048 576 octets) d’un message reçu au-delà de email_inbound_included_bytes, en millicents CAD. Aux tarifs par défaut, un message de 10 Mio coûte 250 + 9 × 200 = 2 050 millicents (0,0205 $). 0 signifie que les courriels reçus ne sont facturés qu’au prix de base.
push_price_millicentsinteger Facturé par livraison push réelle acceptée par un appareil, en millicents CAD : des millièmes de cent, donc 50 correspond à 0,0005 $, soit 0,50 $ par 1 000. Une livraison rejetée est remboursée ; les notifications push en mode test sont gratuites. Absent tant que le push n’est pas offert.
push_free_monthlyinteger Livraisons push réelles acceptées par un appareil qui ne sont pas facturées chaque mois civil (heure de l’Est). 0, la valeur par défaut, signifie que chaque livraison réelle acceptée est facturée au tarif push_price_millicents. Absent tant que le push n’est pas offert.
auth_plansobject Forfaits HonkIO Auth, par application et par mois, en CAD. Un changement s’applique à partir du prochain cycle de facturation de chaque application : un cycle garde les valeurs en vigueur à son début. Les courriels et textos de connexion sont facturés à part, à message_cost_cents et email_price_millicents.
freeobligatoireobject Le forfait gratuit.
fee_centsobligatoireinteger Frais mensuels par application, en cents CAD, prélevés sur le solde prépayé au début de chaque cycle de facturation.
included_usersobligatoireinteger Utilisateurs actifs inclus par cycle de facturation. Un utilisateur compte dès qu’il se connecte au moins un jour après son inscription; les robots probables ne comptent jamais.
overage_tenth_cents_per_userobligatoireinteger Facturé par utilisateur actif au-delà de included_users à la fin du cycle, en dixièmes de cent CAD (25 correspond à 2,5 ¢). Null lorsque le forfait suspend plutôt les nouvelles inscriptions une fois ses utilisateurs inclus atteints (gratuit).
- Peut être null
proobligatoireobject Le forfait Pro.
fee_centsobligatoireinteger Frais mensuels par application, en cents CAD, prélevés sur le solde prépayé au début de chaque cycle de facturation.
included_usersobligatoireinteger Utilisateurs actifs inclus par cycle de facturation. Un utilisateur compte dès qu’il se connecte au moins un jour après son inscription; les robots probables ne comptent jamais.
overage_tenth_cents_per_userobligatoireinteger Facturé par utilisateur actif au-delà de included_users à la fin du cycle, en dixièmes de cent CAD (25 correspond à 2,5 ¢). Null lorsque le forfait suspend plutôt les nouvelles inscriptions une fois ses utilisateurs inclus atteints (gratuit).
- Peut être null
businessobligatoireobject Le forfait Business.
fee_centsobligatoireinteger Frais mensuels par application, en cents CAD, prélevés sur le solde prépayé au début de chaque cycle de facturation.
included_usersobligatoireinteger Utilisateurs actifs inclus par cycle de facturation. Un utilisateur compte dès qu’il se connecte au moins un jour après son inscription; les robots probables ne comptent jamais.
overage_tenth_cents_per_userobligatoireinteger Facturé par utilisateur actif au-delà de included_users à la fin du cycle, en dixièmes de cent CAD (25 correspond à 2,5 ¢). Null lorsque le forfait suspend plutôt les nouvelles inscriptions une fois ses utilisateurs inclus atteints (gratuit).
- Peut être null
Exemple
curl https://api.honkio.ca/v1/pricing \
-H "Authorization: Bearer mk_live_YOUR_KEY"
HonkIO