SDK per sviluppatori

SDK Modiva — un client API per ogni linguaggio

SDK ufficiali e open-source per Node.js, Python, Go, Ruby, Java, PHP, .NET e Rust. Un client tipizzato raggiunge tutte le 38 integrazioni e i 460+ strumenti su social, ads, CRM ed e-commerce — autenticazione, retry, paginazione e idempotenza gestiti per te.

Ottieni la tua chiave API Leggi la documentazione Esplora su GitHub

Linguaggi

Integrazioni

460+

Strumenti

MIT

Open source

Scegli il tuo linguaggio

Ogni SDK segue lo stesso contratto, così documentazione ed esempi si trasferiscono tra i linguaggi. Installa un pacchetto e hai l'intera API.

go get modiva.ai/go

ai.modiva:sdk:0.1.0

Guida SDK Java →

PHP 8.1+

PHP

composer require modiva/sdk

Guida SDK PHP →

net8.0

.NET / C#

dotnet add package Modiva

Avvio rapido

Installa l'SDK, imposta MODIVA_API_KEY e pubblichi in poche righe. Ecco lo stesso flusso in Node.js e Python.

Node.js / TypeScript

import { Modiva } from "@modiva/node";

const modiva = new Modiva(); // reads MODIVA_API_KEY

// List connected accounts
const connections = await modiva.connections.list();

// Publish a post (or schedule with scheduledAt)
await modiva.social.posts.create({
  connectionId: connections[0].id,
  text: "Shipped via the Modiva SDK",
});

Python

import modiva

client = modiva.Modiva()  # reads MODIVA_API_KEY

# List connected accounts
connections = client.connections.list()

# Publish a post (or schedule with scheduled_at)
client.social.posts.create(
    connection_id=connections[0]["id"],
    text="Shipped via the Modiva SDK",
)

Perché usare un SDK Modiva

Gli SDK incapsulano un'unica API REST unificata. Invece di mantenere un client, un flusso OAuth e il refresh dei token per ogni piattaforma, installi un pacchetto e lasci che Modiva normalizzi il resto.

Un client, ogni integrazione

Installa un solo pacchetto e raggiungi tutte le 38 integrazioni — social, ads, CRM ed e-commerce. Nessuna libreria separata per piattaforma.

Tipizzato e idiomatico

Scritto a mano per ogni linguaggio — metodi tipizzati, errori nativi e le convenzioni che il tuo ecosistema si aspetta, non un wrapper generato.

Autenticazione gestita per te

Autenticazione con Bearer key da MODIVA_API_KEY, refresh automatico dei token sul server e OAuth-as-a-service, così il tuo codice non tocca mai i segreti del provider.

Retry e paginazione integrati

429 e 5xx vengono ritentati con backoff esponenziale rispettando Retry-After; le chiamate di creazione sono idempotenti; gli endpoint di elenco paginano automaticamente.

Superficie completa degli strumenti

Helper tipizzati per le azioni comuni, più un tools.execute() generico come via di fuga per ognuno dei 460+ strumenti del catalogo.

Con licenza MIT e aperto

Ogni SDK, la CLI e l'adattatore chat sono open source su GitHub. Leggi il codice, apri issue, invia PR.

CLI e adattatore chat

Oltre agli SDK per linguaggio, il toolkit include un'interfaccia a riga di comando e un adattatore chat — stessa API, superficie diversa.

Modiva CLI

npm i -g modiva

Manage connections, posts and the full tool surface from your terminal.

Chat adapter

npm i @modiva/chat-adapter

One bot, every messaging surface — Instagram, Messenger, WhatsApp, Telegram, X and Discord behind one handler.

Domande frequenti

Which languages does Modiva have an SDK for?

Modiva ships official, open-source SDKs for Node.js / TypeScript, Python, Go, Ruby, Java, PHP, .NET / C# and Rust — eight languages, all following the same contract. A command-line interface and a chat adapter round out the toolkit.

Are the SDKs free and open source?

Yes. Every Modiva SDK, the CLI and the chat adapter are MIT-licensed and published on GitHub at github.com/modiva-dev. You can read the source, file issues and contribute.

Do I need a different SDK for each integration?

No — that's the point. One SDK is a single client for all 38 integrations. Instagram, TikTok, Google Ads, HubSpot, Shopify and every other platform are reached through the same typed methods and the generic tool surface.

How do I authenticate?

Create an API key in the dashboard (MCP keys), then set MODIVA_API_KEY in your environment. The SDK reads it automatically, or you can pass it to the client constructor. Provider OAuth and token refresh are handled by Modiva — your code never sees provider credentials.

Can I use the Modiva API without an SDK?

Yes. Everything is available over a plain REST API, and AI agents can call the same capabilities through the hosted MCP server. The SDKs are a typed convenience layer on top of the same endpoints.

What if my language isn't listed?

Any HTTP client works against the REST API — the SDKs simply add types, retries and pagination. The OpenAPI spec and llms.txt in the docs make it straightforward to generate or hand-roll a client.

Continua a esplorare

Documentazione API →Server MCP →Tutte le integrazioni →API social media →

Metti in produzione la tua prima integrazione oggi

Gratis per iniziare · Primi 3 account collegati gratuiti · Chiave API con un clic

Crea un account gratuito