Wrapper nativi per l'API Ajoxi. Diventa operativo in pochi minuti con client indipendenti dai tipi e verifica webhook integrata.
Stessa superficie in tutte e quattro le lingue. Stessa cadenza di rilascio. Stesso contratto di servizio.
$ npm install @ajoxi/sdk$ pip install ajoxi$ go get github.com/ajoxi/ajoxi-go$ gem install ajoxiLa stessa operazione su ogni SDK: inizializza il client, chiama calls.create, registra il risultato. Scegli una lingua e copia lo snippet.
Tasti modalità test (AJX_TEST_…) effettua chiamate contro il nostro simulatore. Non squillano mai un telefono vero e non fatturano in base alla tua franchigia di minuti: perfetto per CI.
import Ajoxi from '@ajoxi/sdk';
const ajoxi = new Ajoxi({ apiKey: process.env.AJOXI_KEY });
const call = await ajoxi.calls.create({
to: '+14155551234',
from: '+14155550100',
aiReceptionist: true,
});
console.log(call.id, call.status);Ogni SDK Ajoxi include le stesse primitive operative in modo che tu possa concentrarti sulla logica del tuo business.
Definizioni di tipo completo per ogni endpoint e risposta: nessun nome di campo da indovinare.
I segnali acustici di rete e gli errori 5xx riprovano automaticamente con backoff esponenziale, rispettando Retry-After.
Verifica della firma HMAC-SHA256 su una riga con confronto in tempo costante.
Scorre milioni di record senza scrivere un singolo loop del cursore.
Ogni richiesta restituisce un X-Request-Id che puoi citare per supportare - emerso ad ogni errore.
Passa tra le chiavi di test e le chiavi di produzione con un costruttore arg.
Se preferisci lavorare in Rust, PHP, .NET o Elixir, la community è quello che fa per te. Questi non sono proprietari e potrebbero rimanere indietro rispetto alle nuove funzionalità: collegali a una versione testata in produzione.
cargo add ajoxi-rsMantenuto da @ajoxi-communitycomposer require ajoxi/ajoxi-phpMantenuto da @ajoxi-communitydotnet add package AjoxiMantenuto da @ajoxi-communitymix deps.get ajoxi_exMantenuto da @ajoxi-communityScegli quello che corrisponde al tuo tempo di esecuzione. Node.js e Python ricevono per primi gli aggiornamenti delle funzionalità e hanno l'utilizzo di produzione più ampio. Go e Ruby spediscono la stessa superficie entro un rilascio o due. Tutti e quattro sono proprietari, gestiti dal team Ajoxi con lo stesso SLA di supporto.
È etichettato come beta perché l'API pubblica non è stata bloccata: potremmo rinominare uno o due parametri prima della versione 1.0. Funzionalmente copre ogni endpoint ed è in esecuzione nelle nostre pipeline interne da oltre un anno. L'uso produttivo va bene; aggiungi a una versione minore.
Gli SDK hanno come target l'ultima versione stabile dell'API (attualmente v1). Quando viene fornita una nuova versione dell'API, i manutentori dell'SDK aggiornano i client entro due cicli di rilascio: non è necessario scegliere. Gli SDK supportano il blocco di una versione API specifica tramite l'opzione del costruttore per le migrazioni.
SÌ. Node.js è asincrono per impostazione predefinita (tutti i metodi restituiscono Promises). Python fornisce sia client di sincronizzazione che asincroni ("Ajoxi" e "AsyncAjoxi"). Go è sensibile al contesto in ogni chiamata. Ruby è sincrono con la concorrenza basata su fibra disponibile tramite la gem opzionale "ajoxi-async".
L'SDK Node.js viene fornito con tipi TypeScript curati manualmente che coprono ogni endpoint, richiesta e risposta. La restrizione dei tipi di risposte sindacali funziona come ci si aspetterebbe. I tipi generati vengono anche pubblicati separatamente in "@ajoxi/sdk-types" per i progetti che richiedono tipi senza il client runtime.
Sì, tutti e quattro gli SDK sono open source su GitHub. Problemi e PR sono i benvenuti. Ci riserviamo il diritto di riscrivere i dettagli di implementazione per coerenza con i modelli interni, ma la superficie pubblicata viene trattata come un contratto.
Avvia una chiave sandbox e invia un'integrazione funzionante prima della fine della giornata.