renamed verify and verifyv2, add numbers and number insight snippets

Author: maxkahan

number-insight/async-callback/.env.dist

@@ -1,27 +1,41 @@
-This quick demo shows how to accept a Number Insight Async Webhook
+# Verifying Signed Webhooks Demo
+
+This quick demo shows how to recieve an incoming Number Insight webhook.
 
 ## Usage
 
-### Setup
+You may want to use a localhost tunnel agent such as [ngrok](https://ngrok.com/) for local testing.
+
+### Set Up Your Environment
+
+Install dependencies with `pip` in a virtual environment:
+
+```bash
+python3 -m venv venv
+. ./venv/bin/activate
+
+# Point to the requirements file in the root of the python-code-snippets repo
+pip install -r requirements.txt
+```
+
+### Start Your Localhost Tunnel
+
+Start ngrok with `ngrok http 8000`. ngrok will give you a forwarding address you can now use to recieve event webhooks.
+
+### Start the FastAPI Server
 
-Install using either `pipenv` or `virtualenv`, and then set up the webhooks.
+Run the FastAPI server with
 
-#### `pipenv`
-1. Run `pipenv install`
-1. Copy `.env.dist` to `.env` and fill in your credentials
-1. Run `pipenv run flask`
+```bash
+fastapi dev number-insight/async-callback/main.py
+```
 
-#### `virtualenv`
-1. Run `virtualenv env`
-1. Run `source env/bin/activate`
-1. Run `pip install -r requirements.txt`
-1. Copy `.env.dist` to `.env` and fill in your credentials
-1. Run `flask run`
+### Trigger the Lookup
 
-#### Trigger the lookup
-1. Start ngrok with `ngrok http 3000`. ngrok will give you a forwarding address you can now use for your delivery receipts.
+1. Edit the `ni-advanced-async-trigger.py` script to add the number to return insights for.
+1. Add your ngrok URL as the callback to the `number_insight.get_advanced_info_async` method.
 1. Run the trigger script with:
 
     python ni-advanced-async-trigger.py
 
-The output of the webhook should appear in the console output of the Flask application
+The output of the webhook should appear in the console output of the FastAPI application.

number-insight/async-callback/Pipfile

@@ -0,0 +1,9 @@
+from fastapi import FastAPI, Request
+
+app = FastAPI()
+
+
+@app.post('/')
+async def display_advanced_number_insight_info(request: Request):
+    data = await request.json()
+    print(data)

number-insight/async-callback/README.md

@@ -1,34 +1,26 @@
-
 import os
 from os.path import join, dirname
 from pprint import pprint
 from dotenv import load_dotenv
-import vonage
-
-#Load the environment
-envpath = join(dirname(__file__), '../.env')
-load_dotenv(envpath)
 
-#Init the client
-client = vonage.Client(
-    key=os.getenv('VONAGE_API_KEY'),
-    secret=os.getenv('VONAGE_API_SECRET')
-)
+dotenv_path = join(dirname(__file__), '../.env')
+load_dotenv(dotenv_path)
 
-insight_number = os.getenv('INSIGHT_NUMBER')
+VONAGE_API_KEY = os.getenv('VONAGE_API_KEY')
+VONAGE_API_SECRET = os.getenv('VONAGE_API_SECRET')
+INSIGHT_NUMBER = os.getenv('INSIGHT_NUMBER')
 
-#Start the trigger
-insight_trigger_json = client.number_insight.get_async_advanced_number_insight(
-    number=insight_number,
-    callback=os.getenv('INSIGHT_NUMBER_CALLBACK_WEBHOOK')
+from vonage import Auth, Vonage
+from vonage_number_insight import (
+    AdvancedAsyncInsightRequest,
+    AdvancedAsyncInsightResponse,
 )
 
-# You can also pass in JSON
-'''insight_trigger_json = client.number_insight.get_async_advanced_number_insight({
-    "number": insight_number,
-    "callback": os.getenv('INSIGHT_NUMBER_CALLBACK_WEBHOOK')
-})
-'''
+client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))
 
-# Get the response from api - the data will be available on callback webhook
-pprint(insight_trigger_json)
+insight: AdvancedAsyncInsightResponse = client.number_insight.get_advanced_info_async(
+    AdvancedAsyncInsightRequest(
+        number=INSIGHT_NUMBER, callback='https://example.com/insight'
+    )
+)
+pprint(insight)

number-insight/async-callback/app.py

@@ -10,9 +10,12 @@
 VONAGE_API_SECRET = os.getenv('VONAGE_API_SECRET')
 INSIGHT_NUMBER = os.getenv('INSIGHT_NUMBER')
 
-import vonage
+from vonage import Auth, Vonage
+from vonage_number_insight import AdvancedSyncInsightRequest, AdvancedSyncInsightResponse
 
-client = vonage.Client(key=VONAGE_API_KEY, secret=VONAGE_API_SECRET)
+client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))
 
-insight_json = client.number_insight.get_advanced_number_insight(number=INSIGHT_NUMBER)
-pprint(insight_json)
+insight: AdvancedSyncInsightResponse = client.number_insight.get_advanced_info_sync(
+    AdvancedSyncInsightRequest(number=INSIGHT_NUMBER)
+)
+pprint(insight)

number-insight/async-callback/main.py

@@ -15,7 +15,7 @@
 
 client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))
 
-insight: BasicInsightResponse = client.number_insight.basic_number_insight(
+insight: BasicInsightResponse = client.number_insight.get_basic_info(
     BasicInsightRequest(number=INSIGHT_NUMBER)
 )
 pprint(insight)

number-insight/ni-advanced-async-trigger.py

@@ -15,7 +15,7 @@
 
 client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))
 
-insight: StandardInsightResponse = client.number_insight.standard_number_insight(
+insight: StandardInsightResponse = client.number_insight.get_standard_info(
     StandardInsightRequest(number=INSIGHT_NUMBER)
 )
 pprint(insight)

number-insight/ni-advanced.py

@@ -10,12 +10,16 @@
 VONAGE_NUMBER = os.getenv("VONAGE_NUMBER")
 COUNTRY_CODE = os.getenv("COUNTRY_CODE")
 
-import vonage
+from vonage import Auth, Vonage
+from vonage_numbers import NumberParams, NumbersStatus
 
-client = vonage.Client(key=VONAGE_API_KEY, secret=VONAGE_API_SECRET)
+client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))
 
-try:
-    response = client.numbers.buy_number({"country": COUNTRY_CODE, "msisdn": VONAGE_NUMBER})
-    print("Number purchased")
-except Exception as exc:
-    print("Error purchasing number", exc)
+status: NumbersStatus = client.numbers.buy_number(
+    params=NumberParams(
+        country=COUNTRY_CODE,
+        msisdn=VONAGE_NUMBER,
+    )
+)
+
+print(status.model_dump())