Annonce de la version 1.0.0 de la bibliothèque Nexmo PHP Client !

Après un effort héroïque de Tim et du travail de Michael nous sommes fiers d'annoncer que nous venons de marquer la version 1.0 de la bibliothèque client PHP Nexmo - il n'en reste plus qu'une ! composer require de plus !

La technologie

Construit sur Zend Diactoros et Guzzle, c'est un client HTTP compatible PSR-7 pour l'API Nexmo. Initialement, il supporte nos services de base tels que les SMS, Voice, Verify et l'attribution de numéros virtuels et nous nous efforcerons d'ajouter une couverture pour les produits restants au cours du mois prochain.

Que vous soyez un développeur qui aime les entités et les indications de type, ou que vous préfériez tout passer sous forme de tableau, la bibliothèque a quelque chose pour vous. Chacune de nos entités implémente ArrayAccess pour lire les données et accepte les tableaux en tant que paramètres lors de la création et de la mise à jour des entités.

$client = new \Nexmo\Client(new Nexmo\Client\Credentials\Basic('API_KEY', 'API_SECRET'));

$message = $client->message()->search('MESSAGE_ID');

// Read the message ID using a getter or using `ArrayAccess`
echo $message->getNetwork().PHP_EOL;
echo $message['network'];

Exemples

L'interaction avec l'API Nexmo est particulièrement facile lorsque vous utilisez notre bibliothèque client PHP. Vous pouvez envoyer un SMS, passer un appel vocal et utiliser Verify pour valider le numéro d'un utilisateur, le tout en moins de dix lignes de code chacune !

Comment envoyer un SMS ?

$client = new \Nexmo\Client(new Nexmo\Client\Credentials\Basic('API_KEY', 'API_SECRET'));

$client->message()->send([
'from' => '14155550101',
'to' => '14155550100',
'text' => 'A text message sent using the Nexmo SMS API'
]);

Comment passer un appel vocal ?

$keypair = new \Nexmo\Client\Credentials\Keypair(file_get_contents(PRIVATE_KEY), APPLICATION_ID);

$client = new \Nexmo\Client($keypair);

$client->calls()->create([
'to' => [['type' => 'phone', 'number' =>'14155550100']],
'from' => ['type' => 'phone', 'number' =>'14155550101'],
'answer_url' => ['https://nexmo-community.github.io/ncco-examples/first_call_talk.json'],
]);

Comment utiliser 2FA pour vérifier l'identité d'un utilisateur

$client = new Nexmo\Client(new Nexmo\Client\Credentials\Basic(API_KEY, API_SECRET));

$verification = $client->verify()->start([
'number' => '14155550100',
'brand' => 'My App'
]);

// The user submits a form via POST that contains the
// code they received in the `verification_code` input
$client->verify()->check($verification, $_POST['verification_code']);

Points bonus

Si vous êtes un utilisateur de Laravel, nous avons un cadeau spécial pour vous. En plus de notre bibliothèque autonome, nous avons nexmo/laravel qui est un fournisseur de services Laravel pour le client PHP Nexmo. Si vous utilisez Laravel 5.5 ou plus, la bibliothèque s'enregistrera automatiquement en tant que fournisseur, ce qui vous permettra d'utiliser la façade immédiatement.

Une fois que vous avez installé nexmo/laravel et configuré votre clé et votre secret API via .envl'envoi d'un SMS est aussi simple que cela :

Nexmo::message()->send([
'to' => '14155550100',
'from' => '14155550101',
'text' => 'Using the facade to send a message.'
]);

Participez !

Que vous ayez utilisé Nexmo via des notifications SMS dans Laravel (oui, nous le faisons !), que vous ayez construit un énorme système logistique ou quoi que ce soit entre les deux, nous aimerions en savoir plus. Encore mieux si c'est open source et que nous pouvons le citer comme un exemple de la façon de tirer parti de la puissance de Nexmo pour faire le travail.

Si vous souhaitez vous impliquer dans le développement de la bibliothèque du client, il vous suffit de trouver un cas d'utilisation que nous ne prenons pas encore en charge et d'ouvrir un problème. Nous pouvons travailler ensemble pour spécifier et intégrer le support dans le client (nous vous aiderons même à écrire les tests !).