Comptes

Obtenir les détails du compte

Paramètres

Réponses

• 200Le compte avec ses clés API actives.›

  Champ	Type	Description
  accountobligatoire	object	Un compte, tel que le renvoient l’inscription et PATCH /v1/accounts/{id}.
  idobligatoire	string
  nameobligatoire	string
  emailobligatoire	string
  stripe_customer_idobligatoire	string	Peut être null
  email_verified_atobligatoire	string	Format : date-time Peut être null
  statusobligatoire	string	Une valeur parmi : PENDING_PAYMENT | ACTIVE | SUSPENDED | CLOSED
  balance_centsobligatoire	integer	Solde de crédit en cents CAD.
  verified_phoneobligatoire	string	Peut être null
  phone_verified_atobligatoire	string	Format : date-time Peut être null
  email_undeliverableobligatoire	boolean	Vaut true lorsque les courriels de la plateforme envoyés à cette adresse rebondissent ou sont signalés comme pourriels.
  email_undeliverable_atobligatoire	string	Le rebond ou la plainte qui a rendu l’adresse injoignable. Format : date-time Peut être null
  email_undeliverable_reasonobligatoire	string	BOUNCE ou COMPLAINT. Peut être null
  terms_accepted_atobligatoire	string	Moment où le propriétaire a accepté les Conditions d’utilisation et la Politique de confidentialité. Format : date-time Peut être null
  terms_versionobligatoire	string	La version des Conditions (date de dernière mise à jour) qui a été acceptée. Peut être null
  created_atobligatoire	string	Format : date-time
  monthly_rent_centsobligatoire	integer	Loyer mensuel dû pour chaque numéro non encore libéré (ACTIVE et SUSPENDED).
  low_balanceobligatoire	boolean	Vaut true lorsque le solde créditeur ne suffirait pas à couvrir le loyer des numéros de téléphone du mois prochain.
  phone_number_limitobligatoire	integer	Nombre maximal de numéros de téléphone que ce compte peut détenir.
  phone_numbers_usedobligatoire	integer	Numéros actuellement détenus (ACTIVE et SUSPENDED).
  email_domain_limit	integer	Nombre maximal de domaines d’envoi de production que ce compte peut détenir. Présent uniquement lorsque le courriel est offert.
  email_domains_used	integer	Domaines d’envoi de production détenus (tous les statuts sauf FAILED). Présent uniquement lorsque le courriel est offert.
  inbound_email_daily_cap	integer	Nombre de courriels reçus que ce compte peut accepter par période glissante de 24 h avant que les courriels suivants soient stockés comme rejetés, sans facturation (0 = illimité) ; la valeur propre au compte, ou la valeur par défaut de la plateforme. Présent uniquement lorsque le service de courriel est offert.
  inbound_email_received_24h	integer	Courriels reçus comptabilisés dans le plafond ci-dessus, pour la fenêtre glissante actuelle de 24 h. Présent uniquement lorsque le service de courriel est offert.
  inbound_sms_daily_capobligatoire	integer	Nombre de SMS reçus que ce compte peut accepter par période glissante de 24 h avant que les SMS suivants soient stockés sans facturation et ne soient pas transmis en tant que message.received (0 = illimité) ; la valeur propre au compte, ou la valeur par défaut de la plateforme.
  inbound_sms_received_24hobligatoire	integer	SMS reçus comptabilisés dans le plafond ci-dessus, pour la fenêtre glissante actuelle de 24 h.
  api_keys[]obligatoire	object[]	Les clés USER actives du compte (les clés de session du tableau de bord ne sont pas listées).
  idobligatoire	string
  keyPrefixobligatoire	string	Préfixe non secret, pour l’affichage et l’identification.
  modeobligatoire	string	Une valeur parmi : LIVE | TEST
  labelobligatoire	string	Peut être null
  createdAtobligatoire	string	Format : date-time
  lastUsedAtobligatoire	string	Format : date-time Peut être null
  defaultDenyobligatoire	boolean	Présent dans GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion.
  permissionsobligatoire	object	Permissions par ressource. Chaque clé de l’objet est le nom d’une ressource ; la valeur est une chaîne de lettres désignant les opérations permises : r=lecture, w=écriture/création, m=modification/mise à jour, d=suppression. Si une ressource est absente, tout accès à celle-ci est refusé.
  email_domain_idsobligatoire	string[]	Les domaines de courriel à partir desquels cette clé peut envoyer (identifiants provenant de /v1/email-domains) : null en l’absence de restriction, [] lorsqu’elle n’est autorisée pour aucun domaine (ses domaines ont été supprimés). Présent dans GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion. Peut être null
  oauth_grantobligatoire	boolean	Vaut true lorsqu’une connexion OAuth détient cette clé : elle peut être révoquée, mais pas renouvelée (409 CONFLICT, details.reason "oauth_grant"). Présent sur GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion.
  featuresobligatoire	object	Fonctionnalités de la plateforme actuellement offertes à ce compte.
  emailobligatoire	boolean	Vaut true lorsque le produit courriel est offert ; false tant que son accès est encore restreint.
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN : l’identifiant n’appartient pas au compte de la clé appelante, ou la clé n’a pas l’autorisation requise par cette opération.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

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

Mettre à jour le nom ou les paramètres du compte

Paramètres

Corps de la requête

Réponses

• 200Le compte mis à jour.›

  Champ	Type	Description
  idobligatoire	string
  nameobligatoire	string
  emailobligatoire	string
  stripe_customer_idobligatoire	string	Peut être null
  email_verified_atobligatoire	string	Format : date-time Peut être null
  statusobligatoire	string	Une valeur parmi : PENDING_PAYMENT | ACTIVE | SUSPENDED | CLOSED
  balance_centsobligatoire	integer	Solde de crédit en cents CAD.
  verified_phoneobligatoire	string	Peut être null
  phone_verified_atobligatoire	string	Format : date-time Peut être null
  email_undeliverableobligatoire	boolean	Vaut true lorsque les courriels de la plateforme envoyés à cette adresse rebondissent ou sont signalés comme pourriels.
  email_undeliverable_atobligatoire	string	Le rebond ou la plainte qui a rendu l’adresse injoignable. Format : date-time Peut être null
  email_undeliverable_reasonobligatoire	string	BOUNCE ou COMPLAINT. Peut être null
  terms_accepted_atobligatoire	string	Moment où le propriétaire a accepté les Conditions d’utilisation et la Politique de confidentialité. Format : date-time Peut être null
  terms_versionobligatoire	string	La version des Conditions (date de dernière mise à jour) qui a été acceptée. Peut être null
  created_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN : l’identifiant n’appartient pas au compte de la clé appelante, ou la clé n’a pas l’autorisation requise par cette opération.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X PATCH https://api.honkio.ca/v1/accounts/ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Clinics"
  }'

Obtenir le compte auquel appartient la clé API

Réponses

• 200Le compte auquel appartient la clé API.›

  Champ	Type	Description
  accountobligatoire	object	Un compte, tel que le renvoient l’inscription et PATCH /v1/accounts/{id}.
  idobligatoire	string
  nameobligatoire	string
  emailobligatoire	string
  stripe_customer_idobligatoire	string	Peut être null
  email_verified_atobligatoire	string	Format : date-time Peut être null
  statusobligatoire	string	Une valeur parmi : PENDING_PAYMENT | ACTIVE | SUSPENDED | CLOSED
  balance_centsobligatoire	integer	Solde de crédit en cents CAD.
  verified_phoneobligatoire	string	Peut être null
  phone_verified_atobligatoire	string	Format : date-time Peut être null
  email_undeliverableobligatoire	boolean	Vaut true lorsque les courriels de la plateforme envoyés à cette adresse rebondissent ou sont signalés comme pourriels.
  email_undeliverable_atobligatoire	string	Le rebond ou la plainte qui a rendu l’adresse injoignable. Format : date-time Peut être null
  email_undeliverable_reasonobligatoire	string	BOUNCE ou COMPLAINT. Peut être null
  terms_accepted_atobligatoire	string	Moment où le propriétaire a accepté les Conditions d’utilisation et la Politique de confidentialité. Format : date-time Peut être null
  terms_versionobligatoire	string	La version des Conditions (date de dernière mise à jour) qui a été acceptée. Peut être null
  created_atobligatoire	string	Format : date-time
  monthly_rent_centsobligatoire	integer	Loyer mensuel dû pour chaque numéro non encore libéré (ACTIVE et SUSPENDED).
  low_balanceobligatoire	boolean	Vaut true lorsque le solde créditeur ne suffirait pas à couvrir le loyer des numéros de téléphone du mois prochain.
  phone_number_limitobligatoire	integer	Nombre maximal de numéros de téléphone que ce compte peut détenir.
  phone_numbers_usedobligatoire	integer	Numéros actuellement détenus (ACTIVE et SUSPENDED).
  email_domain_limit	integer	Nombre maximal de domaines d’envoi de production que ce compte peut détenir. Présent uniquement lorsque le courriel est offert.
  email_domains_used	integer	Domaines d’envoi de production détenus (tous les statuts sauf FAILED). Présent uniquement lorsque le courriel est offert.
  inbound_email_daily_cap	integer	Nombre de courriels reçus que ce compte peut accepter par période glissante de 24 h avant que les courriels suivants soient stockés comme rejetés, sans facturation (0 = illimité) ; la valeur propre au compte, ou la valeur par défaut de la plateforme. Présent uniquement lorsque le service de courriel est offert.
  inbound_email_received_24h	integer	Courriels reçus comptabilisés dans le plafond ci-dessus, pour la fenêtre glissante actuelle de 24 h. Présent uniquement lorsque le service de courriel est offert.
  inbound_sms_daily_capobligatoire	integer	Nombre de SMS reçus que ce compte peut accepter par période glissante de 24 h avant que les SMS suivants soient stockés sans facturation et ne soient pas transmis en tant que message.received (0 = illimité) ; la valeur propre au compte, ou la valeur par défaut de la plateforme.
  inbound_sms_received_24hobligatoire	integer	SMS reçus comptabilisés dans le plafond ci-dessus, pour la fenêtre glissante actuelle de 24 h.
  api_keys[]obligatoire	object[]	Les clés USER actives du compte (les clés de session du tableau de bord ne sont pas listées).
  idobligatoire	string
  keyPrefixobligatoire	string	Préfixe non secret, pour l’affichage et l’identification.
  modeobligatoire	string	Une valeur parmi : LIVE | TEST
  labelobligatoire	string	Peut être null
  createdAtobligatoire	string	Format : date-time
  lastUsedAtobligatoire	string	Format : date-time Peut être null
  defaultDenyobligatoire	boolean	Présent dans GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion.
  permissionsobligatoire	object	Permissions par ressource. Chaque clé de l’objet est le nom d’une ressource ; la valeur est une chaîne de lettres désignant les opérations permises : r=lecture, w=écriture/création, m=modification/mise à jour, d=suppression. Si une ressource est absente, tout accès à celle-ci est refusé.
  email_domain_idsobligatoire	string[]	Les domaines de courriel à partir desquels cette clé peut envoyer (identifiants provenant de /v1/email-domains) : null en l’absence de restriction, [] lorsqu’elle n’est autorisée pour aucun domaine (ses domaines ont été supprimés). Présent dans GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion. Peut être null
  oauth_grantobligatoire	boolean	Vaut true lorsqu’une connexion OAuth détient cette clé : elle peut être révoquée, mais pas renouvelée (409 CONFLICT, details.reason "oauth_grant"). Présent sur GET /v1/accounts/me et /v1/accounts/{id} ; absent de la réponse de connexion.
  featuresobligatoire	object	Fonctionnalités de la plateforme actuellement offertes à ce compte.
  emailobligatoire	boolean	Vaut true lorsque le produit courriel est offert ; false tant que son accès est encore restreint.
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

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

Allocation de recharge (plafond de solde et plafond sur 30 jours glissants)

Paramètres

Réponses

• 200Montant qu’il est possible d’ajouter maintenant. Les montants sont en cents CAD.›

  Champ	Type	Description
  max_topup_now_centsobligatoire	integer	La recharge la plus élevée acceptée actuellement : la plus petite des deux marges disponibles.
  headroom_balance_centsobligatoire	integer	Marge restante sous le plafond de solde.
  headroom_30d_centsobligatoire	integer	Marge restante sous le plafond glissant de 30 jours.
  max_balance_centsobligatoire	integer
  max_30d_centsobligatoire	integer
  balance_centsobligatoire	integer
  topped_up_30d_centsobligatoire	integer
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN : l’identifiant n’appartient pas au compte de la clé appelante, ou la clé n’a pas l’autorisation requise par cette opération.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl https://api.honkio.ca/v1/accounts/ID/topup-allowance \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Obtenir le résumé d’utilisation d’une période de facturation

Paramètres

Réponses

• 200Utilisation pour la période. Les noms de champs sont en camelCase, contrairement au reste de l’API.›

  Champ	Type	Description
  totalMessagesobligatoire	integer	Tous les messages de la période, y compris les messages entrants et ceux en mode test.
  testMessagesobligatoire	integer	Nombre de messages, parmi totalMessages, qui étaient des simulations en mode test, sans aucuns frais.
  outboundMessagesobligatoire	integer
  inboundMessagesobligatoire	integer
  totalCostCentsobligatoire	integer	Coût des messages LIVE, en cents CAD.
  segmentCountobligatoire	integer	Parties SMS facturées en mode LIVE.
  deliveryobligatoire	object
  liveOutboundobligatoire	integer
  deliveredobligatoire	integer
  failedobligatoire	integer
  undeliveredobligatoire	integer
  pendingobligatoire	integer	Accepté, aucun verdict de l’opérateur pour l’instant.
  failureRatePctobligatoire	number	(failed + undelivered) / liveOutbound x 100, arrondi à une décimale ; 0 en l’absence de trafic.
  byNumber[]obligatoire	object[]	Les mêmes statistiques de livraison par numéro d’envoi, du plus actif au moins actif.
  fromobligatoire	string
  liveOutboundobligatoire	integer
  deliveredobligatoire	integer
  failedobligatoire	integer
  undeliveredobligatoire	integer
  failureRatePctobligatoire	number
  periodobligatoire	object
  fromobligatoire	string	Format : date-time
  toobligatoire	string	Fin exclusive de la période. Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN : l’identifiant n’appartient pas au compte de la clé appelante, ou la clé n’a pas l’autorisation requise par cette opération.Le corps d’erreur standard.
• 422VALIDATION_ERROR : date mal formée, ou to antérieur à from.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl https://api.honkio.ca/v1/accounts/ID/usage \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Lister les transactions du solde (grand livre), des plus récentes aux plus anciennes

Paramètres

Réponses

• 200Registre paginé des transactions du solde›

  Champ	Type	Description
  transactions[]	object[]
  id	string
  amount_cents	integer	Valeur signée : positive = crédit, négative = débit
  balance_after_cents	integer
  reason	string	Raison du mouvement de solde : topup, refund, dispute, phone_rent, provisioning, activation, verification et leurs annulations *_refund ; admin_adjustment pour les modifications faites par notre équipe. Les frais SMS par message n’apparaissent pas ici : ils figurent sur les messages eux-mêmes. Les corrections ponctuelles portent leurs propres raisons (inbound_backfill, overcharge_refund, sweep_reversal).
  tax_cents	integer	Recharges seulement, lorsque des taxes de vente ont été perçues : la TPS/TVH facturée en sus de amount_cents. amount_cents correspond toujours au crédit, avant taxes. Absent dans les autres cas.
  charged_cents	integer	Recharges seulement, lorsque des taxes de vente ont été perçues : le montant débité de la carte, soit amount_cents plus tax_cents. Absent dans les autres cas.
  created_at	string	Format : date-time
  has_more	boolean
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404NOT_FOUND : également lorsque l’id n’est pas celui du compte de la clé appelante (404 plutôt que 403, afin de ne pas confirmer l’existence du grand livre).Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl https://api.honkio.ca/v1/accounts/ID/transactions \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Émettre une nouvelle clé API

Paramètres

Corps de la requête

Réponses

• 201Clé API émise. La clé brute n’est affichée qu’une seule fois : conservez-la en lieu sûr.›

  Champ	Type	Description
  key	string	Clé API complète (affichée une seule fois)
  prefix	string	Préfixe non secret pour l’affichage et l’identification
  mode	string	Une valeur parmi : live | test
  permissions	object	Permissions par ressource.
  email_domain_ids	string[]	Peut être null
  notice	string
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte), LIVE_KEY_REQUIRED (une clé de test a demandé une clé de production), KEY_FENCED (la clé appelante est restreinte par une liste d’autorisation ou de blocage) ou PERMISSION_ESCALATION (autorisations ou domaines courriel plus étendus que ceux de la clé appelante, ou clé de session du tableau de bord, sans confirmation par mot de passe api_keys:elevate).Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X POST https://api.honkio.ca/v1/accounts/ID/api-keys \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "live",
    "label": "Production server"
  }'

Renouveler une clé API (émettre une clé de remplacement et révoquer l’ancienne de façon atomique)

Paramètres

Réponses

• 201La clé de remplacement, affichée une seule fois. L’ancienne clé est révoquée dans la même opération ; la nouvelle conserve son mode, son libellé, ses permissions, son paramètre de refus par défaut, ses listes et sa restriction de domaines de courriel.›

  Champ	Type	Description
  keyobligatoire	string	La nouvelle clé API complète (affichée une seule fois).
  prefixobligatoire	string
  modeobligatoire	string	Une valeur parmi : live | test
  revoked_idobligatoire	string	L’identifiant de la clé que celle-ci a remplacée.
  noticeobligatoire	string
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte), LIVE_KEY_REQUIRED (une clé de test tente de renouveler une clé de production), KEY_FENCED (une clé restreinte par une liste d’autorisation ou de blocage tente de renouveler une autre clé qu’elle-même) ou PERMISSION_ESCALATION (la clé cible détient plus d’autorisations que la clé appelante, ou l’appelant est une clé de session du tableau de bord, sans confirmation par mot de passe api_keys:elevate).Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 409CONFLICT : la clé est déjà révoquée, est en cours de renouvellement par une autre requête, est une clé de session du tableau de bord (details.reason vaut session_key) ou est détenue par une connexion OAuth (details.reason vaut oauth_grant).Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X POST https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID/rotate \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Révoquer une clé API

Paramètres

Réponses

• 204Révocation effectuée.
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte) ou LIVE_KEY_REQUIRED (une clé de test tente de révoquer une clé de production).Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X DELETE https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Activer ou désactiver le mode de refus par défaut d’une clé API

Paramètres

Corps de la requête

Réponses

• 200Le nouveau paramètre de refus par défaut de la clé.›

  Champ	Type	Description
  api_key_idobligatoire	string
  default_denyobligatoire	boolean
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte), LIVE_KEY_REQUIRED (une clé de test tente de modifier une clé de production) ou KEY_FENCED (une clé restreinte tente de modifier son propre refus par défaut ou celui d’une autre clé).Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X PATCH https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID/default-deny \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_deny": false
  }'

Obtenir les listes d’autorisation et de blocage attribuées à une clé API

Paramètres

Réponses

• 200Les listes d’autorisation et de blocage de la clé, null si aucune n’est attribuée.›

  Champ	Type	Description
  allow_listobligatoire	object | any
  deny_listobligatoire	object | any
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN : l’identifiant n’appartient pas au compte de la clé appelante, ou la clé n’a pas l’autorisation requise par cette opération.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID/lists \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Assigner une liste d’autorisation ou de blocage à une clé API

Paramètres

Corps de la requête

Réponses

• 200La liste désormais attribuée.›

  Champ	Type	Description
  api_key_idobligatoire	string
  modeobligatoire	string	Une valeur parmi : ALLOW | DENY
  list_idobligatoire	string
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte), LIVE_KEY_REQUIRED (une clé de test tente de modifier une clé de production) ou KEY_FENCED (une clé restreinte tente de modifier ses propres listes ou celles d’une autre clé).Le corps d’erreur standard.
• 404NOT_FOUND (clé inexistante) ou CONTACT_LIST_NOT_FOUND.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X PUT https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID/lists/MODE \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "..."
  }'

Retirer une liste d’autorisation ou de blocage d’une clé API

Paramètres

Réponses

• 204Attribution retirée (également lorsque rien n’était attribué).
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte), LIVE_KEY_REQUIRED (une clé de test tente de modifier une clé de production) ou KEY_FENCED (une clé restreinte tente de modifier ses propres listes ou celles d’une autre clé).Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X DELETE https://api.honkio.ca/v1/accounts/ID/api-keys/KEY_ID/lists/MODE \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Démarrer la vérification du numéro du propriétaire du compte

Paramètres

Corps de la requête

Réponses

• 200Le code a été envoyé par SMS.›

  Champ	Type	Description
  sentobligatoire	boolean	Une valeur parmi : true
  expires_in_secondsobligatoire	integer
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte) ou LIVE_KEY_REQUIRED (la vérification du propriétaire nécessite une clé de production).Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429RATE_LIMITED : 3 codes par heure et par compte.Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.
• 502CARRIER_ERROR : l’opérateur n’a pas accepté le SMS.Le corps d’erreur standard.
• 503SERVICE_UNAVAILABLE : la vérification du numéro du propriétaire n’est pas configurée.Le corps d’erreur standard.

Exemple

curl -X POST https://api.honkio.ca/v1/accounts/ID/phone-verification \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1613XXXXXXX"
  }'

Confirmer le code de vérification (NPU) pour terminer la vérification du numéro de téléphone

Paramètres

Corps de la requête

Réponses

• 200Vérifié : les envois réels sont débloqués.›

  Champ	Type	Description
  verifiedobligatoire	boolean	Une valeur parmi : true
  verified_phoneobligatoire	string
  verified_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (ce n’est pas votre compte) ou LIVE_KEY_REQUIRED (la vérification du propriétaire nécessite une clé de production).Le corps d’erreur standard.
• 422VALIDATION_ERROR, VERIFICATION_EXPIRED (aucun code en attente ; statusCode 422 dans le corps) ou VERIFICATION_INVALID_CODE.Le corps d’erreur standard.
• 429VERIFICATION_MAX_ATTEMPTS : cinq codes erronés ; demandez-en un nouveau.Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X POST https://api.honkio.ca/v1/accounts/ID/phone-verification/confirm \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "123456"
  }'

Vos limites d’envoi et votre utilisation actuelle

Réponses

• 200Limites d’envoi, utilisation et demandes de volume antérieures.›

  Champ	Type	Description
  daily_limitobligatoire	integer	Envois réels autorisés sur une période mobile de 24 heures.
  sent_last_24hobligatoire	integer
  remainingobligatoire	integer
  window_hoursobligatoire	integer
  approved_daily_limitobligatoire	integer	Le volume standard accordé par défaut à une demande.
  probation_daysobligatoire	integer
  recipient_rate_per_hourobligatoire	integer	Messages qu’un même destinataire peut recevoir du compte par heure.
  recipient_rate_per_dayobligatoire	integer	Messages qu’un même destinataire peut recevoir du compte par jour.
  probationobligatoire	object
  started_atobligatoire	string	Le premier envoi réel ; null avant celui-ci. Format : date-time Peut être null
  ends_atobligatoire	string	Format : date-time Peut être null
  eligible_to_requestobligatoire	boolean
  paused_untilobligatoire	string	Défini pendant que l’envoi est en pause. Format : date-time Peut être null
  pause_reasonobligatoire	string	Raison de la pause des envois : OPT_OUT_RATE, FAILURE_RATE ou MANUAL. Peut être null
  requests[]obligatoire	object[]
  idobligatoire	string
  requested_limitobligatoire	integer	Nombre de messages par jour demandé ; null demande le volume approuvé standard. Peut être null
  limit_at_requestobligatoire	integer
  sent_last_30d_at_requestobligatoire	integer
  reasonobligatoire	string
  statusobligatoire	string	Une valeur parmi : PENDING | APPROVED | DENIED
  granted_limitobligatoire	integer	Peut être null
  staff_noteobligatoire	string	Peut être null
  decided_atobligatoire	string	Format : date-time Peut être null
  created_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

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

Lister vos demandes de volume

Réponses

• 200Les demandes de volume du compte, des plus récentes aux plus anciennes.›

  Champ	Type	Description
  data[]obligatoire	object[]
  idobligatoire	string
  requested_limitobligatoire	integer	Nombre de messages par jour demandé ; null demande le volume approuvé standard. Peut être null
  limit_at_requestobligatoire	integer
  sent_last_30d_at_requestobligatoire	integer
  reasonobligatoire	string
  statusobligatoire	string	Une valeur parmi : PENDING | APPROVED | DENIED
  granted_limitobligatoire	integer	Peut être null
  staff_noteobligatoire	string	Peut être null
  decided_atobligatoire	string	Format : date-time Peut être null
  created_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl https://api.honkio.ca/v1/send-limit/requests \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Demander un volume d’envoi quotidien plus élevé

Corps de la requête

Réponses

• 201La demande, en attente d’examen.›

  Champ	Type	Description
  idobligatoire	string
  requested_limitobligatoire	integer	Nombre de messages par jour demandé ; null demande le volume approuvé standard. Peut être null
  limit_at_requestobligatoire	integer
  sent_last_30d_at_requestobligatoire	integer
  reasonobligatoire	string
  statusobligatoire	string	Une valeur parmi : PENDING | APPROVED | DENIED
  granted_limitobligatoire	integer	Peut être null
  staff_noteobligatoire	string	Peut être null
  decided_atobligatoire	string	Format : date-time Peut être null
  created_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403SEND_LIMIT_REQUEST_TOO_EARLY (période probatoire non terminée ; details.eligible_at) ou LIVE_KEY_REQUIRED.Le corps d’erreur standard.
• 404NOT_FOUND : aucune ressource correspondante sur ce compte.Le corps d’erreur standard.
• 409SEND_LIMIT_REQUEST_PENDING : une demande est déjà en attente.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429RATE_LIMITED : 3 requêtes par jour et par compte.Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

curl -X POST https://api.honkio.ca/v1/send-limit/requests \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "..."
  }'