API
1MSG SDK: llama a la API de WhatsApp desde tu idioma
Un cliente 1MSG para TypeScript, Python, Go, Java, C#, y más. Mismo API de WhatsApp: instala desde el registro, llama a métodos, omite HTTP escrito a mano.
Nikita L ·
Si ya llamas a 1MSG a través de HTTP, eso aún funciona. Los puntos finales, los tokens y las formas de respuesta no cambian. Lo nuevo es que puedes dejar de ensamblar esas solicitudes tú mismo.
¿Por qué existe esto?
Sin un SDK, cada llamada es una solicitud HTTP escrita a mano: URL, token, cuerpo JSON, tus propios tipos y manejo de errores. Lo copias de Documentación API y te aseguras de que esté correcto. El SDK es esa capa como un paquete en tu lenguaje: llamas a métodos contra la misma API.
Los clientes se generan del mismo contrato de OpenAPI que el servidor, por lo que siguen la API en lugar de desviarse de un curl copiado. Ese era el objetivo de la reconstrucción del backend.
Comienza aquí
Necesitas tres valores de la página del canal: baseUrl, instanceId, y token. Después de eso, llamas a un método, no a una URL. Si aún no tienes un canal, el Inicio rápido cubre la cuenta, canal de prueba y el primer mensaje.
TypeScript es el camino más corto. Instala con npm install @1msg/sdk, luego:
import { createClient } from '@1msg/sdk';
const client = createClient({
baseUrl: 'https://api.1msg.io',
instanceId: 'YOUR_INSTANCE_ID',
token: process.env.MSG_API_TOKEN!,
});
await client.sendMessage({ body: 'Hello', chatId: '[email protected]' });Los otros idiomas funcionan de la misma manera: las mismas tres credenciales, la misma sendMessage llamada. Los comandos de instalación y los repositorios están abajo.
Instalar
La mayoría de los lenguajes se instalan desde un registro de paquetes. PHP y C++ son solo de código fuente por ahora.
| Idioma | Instalar | Fuente |
|---|---|---|
| TypeScript | npm install @1msg/sdk | https://github.com/1msg/1msg-sdk/tree/main/typescript |
| Python | pip install one-msg-sdk | https://github.com/1msg/1msg-sdk/tree/main/python |
| Java | implementation("io.1msg:sdk") | https://github.com/1msg/1msg-sdk/tree/main/java |
| Kotlin | implementation("io.1msg:sdk-kotlin") | https://github.com/1msg/1msg-sdk/tree/main/kotlin |
| Scala | "io.1msg" %% "sdk-scala" | https://github.com/1msg/1msg-sdk/tree/main/scala |
| C# | dotnet add package OneMsg.Sdk | https://github.com/1msg/1msg-sdk/tree/main/csharp |
| Ruby | gem install one_msg_sdk | https://github.com/1msg/1msg-sdk/tree/main/ruby |
| Rust | cargo add one-msg-sdk | https://github.com/1msg/1msg-sdk/tree/main/rust |
| Go | go get github.com/1msg/1msg-sdk-go | https://github.com/1msg/1msg-sdk-go |
| Swift | SwiftPM: 1msg-sdk-swift | https://github.com/1msg/1msg-sdk-swift |
| PHP | composer require 1msg/sdk from GitHub (Packagist not published yet) | https://github.com/1msg/1msg-sdk-php |
| C++ | git clone + CMake (no registry yet) | https://github.com/1msg/1msg-sdk-cpp |
PHP de GitHub:
composer config repositories.1msg vcs https://github.com/1msg/1msg-sdk-php
composer require 1msg/sdkC++: git clone https://github.com/1msg/1msg-sdk-cpp.git
Elige tu idioma, instala el paquete y envía el primer mensaje con baseUrl, instanceId, y token desde la página del canal. HTTP en crudo permanece sin cambios: el SDK es la misma API, como un cliente.