Référence de l’API

Tarifs

Prix actuels par envoi, pour qu’un intégrateur puisse estimer un coût avant d’envoyer.

get/v1/pricing

Prix actuels par envoi, en cents CAD

Réponses

  • 200Prix actuels. Tous les montants sont en cents CAD.
    ChampTypeDescription
    message_cost_centsinteger

    Facturé par partie SMS, comptée 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 partie) ; les émojis et la plupart des lettres accentuées imposent des parties Unicode (70, puis 67). Le montant facturé est ajusté au nombre de parties compté par l’opérateur après l’envoi. Les corps de plus de 10 parties 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 une seule partie : message_cost_cents + verification_upcharge_cents. Un app_name long ou hors GSM peut faire passer le code de vérification (NPU) à deux parties et augmenter ce montant ; les frais sont ajustés au nombre de parties 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 facturés avec le premier mois pour chaque numéro (local et sans frais). 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.

    inbound_message_cost_centsinteger

    Facturé par partie SMS de chaque SMS entrant reçu sur un numéro provisionné, selon le nombre de parties é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.

Exemple

cURL
curl https://api.honkio.ca/v1/pricing \
  -H "Authorization: Bearer mk_live_YOUR_KEY"