Aller au contenu
shareto

ShareTo API

Publiez depuis votre propre code

Une seule API REST pour connecter des comptes et publier ou programmer sur Instagram, Facebook, YouTube, LinkedIn et TikTok. Créez autant de clés d’API que nécessaire.

URL de basehttps://shareto.social/api/v1

  1. S’authentifier

    Créez une clé dans Paramètres, section API, puis envoyez-la comme jeton Bearer à chaque requête. Les clés sont illimitées, affichées une seule fois et révocables à tout moment.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. Connecter un compte

    Demandez un lien de connexion et ouvrez-le dans un navigateur, ou envoyez-le au propriétaire du compte. Il donne son accord sur la plateforme et revient sur votre redirectUrl. Le lien reste valable 30 minutes.

    curl -X POST https://shareto.social/api/v1/accounts/connect \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }'
    
    # 201
    { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...",
                "expiresAt": "2026-11-10T10:30:00.000Z" } }
  3. Envoyer des médias

    Obtenez une autorisation d’envoi, puis envoyez le fichier avec PUT vers putUrl. Les grandes vidéos peuvent reprendre via tus. Utilisez l’url renvoyée dans votre publication.

    curl -X POST https://shareto.social/api/v1/uploads \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }'
    
    curl -X PUT "$PUT_URL" \
      -H "Authorization: Bearer $UPLOAD_TOKEN" \
      -H "Content-Type: video/mp4" \
      --data-binary @launch.mp4
  4. Publier ou programmer

    Envoyez le texte, les médias et les identifiants de comptes. Laissez scheduledAt vide pour publier tout de suite, ou indiquez une heure ISO pour programmer. Chaque compte a son propre statut.

    curl -X POST https://shareto.social/api/v1/posts \
      -H "Authorization: Bearer st_live_..." \
      -H "Content-Type: application/json" \
      -d '{
        "kind": "reel",
        "caption": "Behind the scenes",
        "media": [{ "url": "$MEDIA_URL", "type": "video" }],
        "accountIds": ["$ACCOUNT_ID"],
        "scheduledAt": "2026-11-12T09:00:00Z"
      }'

Points de terminaison

MéthodeCheminRôle
GET/accountsLister les comptes connectés
GET/accounts/{id}Obtenir un compte
POST/accounts/connectCréer un lien de connexion pour une plateforme
DELETE/accounts/{id}Déconnecter un compte et annuler ses publications programmées
POST/uploadsObtenir une autorisation d’envoi unique pour un fichier
POST/postsPublier tout de suite ou programmer une publication
GET/posts?ids=a,bObtenir les 50 dernières publications, ou celles indiquées dans ids
GET/posts/{id}Obtenir une publication avec le statut de chaque compte
DELETE/posts/{id}Supprimer une publication qui n’est pas encore en ligne

Modes de connexion

Un compte se connecte via Zernio, une API de publication partenaire dont les applications sont approuvées par les plateformes pour publier en public, ou directement via les applications de ShareTo. Indiquez connection avec auto, zernio ou direct. Avec auto, ShareTo choisit le mode pour chaque plateforme.

Erreurs

Les erreurs arrivent en JSON avec un message. Code 401 pour une clé absente ou erronée, 404 si l’élément n’est pas dans votre espace de travail, 422 si la requête enfreint une règle de la plateforme. Le message indique quoi corriger.

ShareTo est en bêta privée. Demandez un accès pour ouvrir un espace de travail.