HonkIODes SDK HonkIO pour Python, PHP et Laravel
Les SDK HonkIO officiels pour Python et PHP sont arrivés, avec un paquet Laravel qui envoie vos courriels et vos notifications SMS par HonkIO.
Jusqu'à aujourd'hui, si vous n'écriviez pas en JavaScript, utiliser HonkIO voulait dire écrire vos propres appels HTTP. Il existe maintenant des SDK officiels pour Python et PHP, ainsi qu'un paquet pour Laravel. Ils couvrent la même API que @honkio/node : SMS, courriel, consentement LCAP, numéros de téléphone, codes de vérification et webhooks.
Python
honkio sur PyPI fonctionne avec Python 3.10 ou plus récent et offre un client classique et un client asynchrone.
pip install honkioimport os
from honkio import Honkio
client = Honkio(os.environ["HONKIO_API_KEY"])
# "from_" is one of your HonkIO numbers; "to" is a real number you hold consent for
message = client.messages.send(
from_="+1416XXXXXXX",
to="+1613XXXXXXX",
body="Hello from HonkIO! 🇨🇦",
)
print(message["id"], message["status"])PHP
honkio/honkio-php sur Packagist fonctionne avec PHP 8.2 ou plus récent.
composer require honkio/honkio-php<?php
use Honkio\Honkio;
$honkio = new Honkio(getenv('HONKIO_API_KEY'));
// "from" is one of your HonkIO numbers; "to" is a real number you hold consent for
$message = $honkio->messages->send([
'from' => '+1416XXXXXXX',
'to' => '+1613XXXXXXX',
'body' => 'Hello from HonkIO! 🇨🇦',
]);
echo $message['id'], ' ', $message['status'], "\n";Dans les deux langages, une erreur de l'API est une exception que vous pouvez intercepter, avec les mêmes codes d'erreur que ceux documentés par l'API.
Laravel
honkio/laravel s'adresse à Laravel 12 et 13. Il ajoute un transport de courriel honkio, pour que vos Mailables existants passent par HonkIO, et un canal de notification honkio pour les SMS :
composer require honkio/laravel<?php
use Honkio\Laravel\Notifications\HonkioMessage;
use Illuminate\Notifications\Notification;
class ShipmentSent extends Notification
{
public function via($notifiable): array
{
return ['honkio'];
}
public function toHonkio($notifiable): HonkioMessage
{
return HonkioMessage::create('Your order has shipped.')
->from('+14165550100'); // optional, defaults to HONKIO_SMS_FROM
}
}Pour la suite
Le guide des SDK, à honkio.ca/fr/docs/sdk, a une section pour chacun : Python, PHP et Laravel. Commencez avec une clé de test, qui ne livre et ne facture rien. Le code source PHP et Laravel est sur GitHub, à somecorp-dev/honkio-php et somecorp-dev/honkio-laravel, où vous pouvez signaler des problèmes.