SDK pour développeurs

SDK Modiva — un client API pour chaque langage

Des SDK officiels open source pour Node.js, Python, Go, Ruby, Java, PHP, .NET et Rust. Un seul client typé atteint l'ensemble des 38 intégrations et des 460+ outils sur le social, les ads, le CRM et l'e-commerce — authentification, retries, pagination et idempotence gérés pour vous.

Obtenez votre clé API Lire la documentation Parcourir sur GitHub

Langages

Intégrations

460+

Outils

MIT

Open source

Choisissez votre langage

Chaque SDK suit le même contrat, si bien que la documentation et les exemples se transposent d'un langage à l'autre. Installez un paquet et vous disposez de toute l'API.

Node 18+

Node.js / TypeScript

npm i @modiva/node

Guide du SDK Node.js →

Python 3.9+

Python

pip install modiva

Guide du SDK Python →

Go 1.21+

go get modiva.ai/go

ai.modiva:sdk:0.1.0

Guide du SDK Java →

PHP 8.1+

PHP

composer require modiva/sdk

Guide du SDK PHP →

net8.0

.NET / C#

dotnet add package Modiva

Démarrage rapide

Installez le SDK, définissez MODIVA_API_KEY et vous publiez en quelques lignes. Voici le même flux en Node.js et 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",
)

Pourquoi utiliser un SDK Modiva

Les SDK enveloppent une seule API REST unifiée. Au lieu de maintenir un client, un flux OAuth et le rafraîchissement des tokens pour chaque plateforme, vous installez un paquet et laissez Modiva normaliser le reste.

Un client, toutes les intégrations

Installez un seul paquet et atteignez l'ensemble des 38 intégrations — social, ads, CRM et e-commerce. Aucune bibliothèque distincte par plateforme.

Typé et idiomatique

Écrit à la main pour chaque langage — méthodes typées, erreurs natives et conventions attendues par votre écosystème, pas un wrapper généré.

Authentification gérée pour vous

Authentification par clé Bearer depuis MODIVA_API_KEY, rafraîchissement automatique des tokens côté serveur et OAuth-as-a-service, si bien que votre code ne touche jamais aux secrets des fournisseurs.

Retries et pagination intégrés

Les 429 et 5xx sont réessayés avec un backoff exponentiel respectant Retry-After ; les appels de création sont idempotents ; les endpoints de liste paginent automatiquement.

Surface d'outils complète

Des helpers typés pour les actions courantes, plus une échappatoire générique tools.execute() pour chacun des 460+ outils du catalogue.

Sous licence MIT et ouvert

Chaque SDK, la CLI et l'adaptateur de chat sont open source sur GitHub. Lisez le code, ouvrez des issues, envoyez des PR.

CLI et adaptateur de chat

Au-delà des SDK par langage, la boîte à outils comprend une interface en ligne de commande et un adaptateur de chat — même API, surface différente.

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.

Questions fréquentes

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.

Continuez à explorer

Documentation de l'API →Serveurs MCP →Toutes les intégrations →API de réseaux sociaux →

Mettez en production votre première intégration dès aujourd'hui

Gratuit pour commencer · 3 premiers comptes connectés gratuits · Clé API en un clic

Créer un compte gratuit