> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide de l'API de réseaux sociaux

> Créez une clé d'API et programmez votre première publication sur Instagram, LinkedIn, X, TikTok et plus encore en un seul appel REST. Exemples curl fonctionnels pour les publications et les médias.

## Prérequis

Avant de commencer, assurez-vous d'avoir :

1. Un compte Social media studio avec au moins un compte social connecté
2. Une clé d'API (voir [Authentification](/fr/authentication.md))

## URL de base

Toutes les requêtes API doivent être envoyées à :

```
https://api.so-me.studio/v1
```

## Créer une publication

Envoyez une requête `POST` pour créer une nouvelle publication :

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "socialMedia": "TWITTER",
    "postType": "TEXT"
  }'
```

> [!NOTE]
>
> `socialMedia` accepte n'importe laquelle des 16 destinations de publication
> (comme `TWITTER`, `LINKEDIN`, `INSTAGRAM`, `FACEBOOK`, `TIKTOK`, `YOUTUBE`,
> `THREADS`, `PINTEREST`, `BLUESKY`, et d'autres), pas seulement les quelques-unes
> utilisées dans ces exemples. `WHATSAPP` et `TELEGRAM` sont réservées à la
> messagerie et ne peuvent pas recevoir de publications. Consultez
> [Connecter des comptes](/fr/get-started/connecting-accounts.md) pour la liste
> complète des plateformes prises en charge.

```json Réponse theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "text": "Hello from the API!",
  "socialMedia": "TWITTER",
  "postType": "TEXT",
  "postStatus": "SCHEDULED",
  "createdAt": "2025-01-15T09:00:00.000Z"
}
```

## Programmer une publication

Pour programmer une publication à une date ultérieure, incluez `scheduledAt` lors de la création :

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Scheduled post!",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'
```

Ou programmez une publication existante :

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts/{id}/schedule \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'
```

## Lister les publications

Récupérez les publications de votre espace de travail avec un filtrage facultatif. Le filtre `status` correspond
au champ `postStatus` renvoyé dans les réponses, et `socialMedia` filtre par
plateforme :

```bash theme={null}
curl "https://api.so-me.studio/v1/posts?status=SCHEDULED&socialMedia=TWITTER&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Téléverser des médias

Pour les publications avec image ou vidéo, obtenez d'abord une URL de téléversement présignée :

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts/presign-media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postType": "IMAGE",
    "socialMedia": "INSTAGRAM",
    "files": [{
      "filename": "photo.jpg",
      "mimetype": "image/jpeg",
      "size": 1024000
    }]
  }'
```

Téléversez ensuite votre fichier vers l'`uploadUrl` renvoyée avec une requête HTTP `PUT`. Envoyez un
en-tête `Content-Type` égal au `mimetype` que vous avez déclaré :

```bash theme={null}
curl -X PUT "UPLOAD_URL_FROM_THE_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
```

> [!WARNING]
>
> L'URL de téléversement est signée avec le `mimetype` déclaré. Un `PUT` sans
> en-tête `Content-Type` (par exemple avec `curl -T` ou
> `requests.put(url, data=f)` en Python), ou avec une valeur différente, échoue avec
> `403 SignatureDoesNotMatch`.

Utilisez ensuite `s3Prefix` et `fileSrc` dans votre requête de création de publication.

## Étapes suivantes

> **[Référence de l'API](/fr/api-reference)**
>
> Référence complète des endpoints avec playground interactif

> **[Serveur MCP](/fr/mcp/overview.md)**
>
> Connectez des agents IA via le Model Context Protocol


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.