Aller au contenu

Plateforme pour développeurs

API de publication sur les réseaux sociaux pour développeurs sur de véritables iPhones

The social media posting API for developers that runs on real iPhones. Your code posts to TikTok, Instagram and YouTube through a REST API or an OAuth-authenticated MCP server, and a real iPhone does the work. Need a human? Take the screen in the browser.

Trois objets de base. Emplacement, compte, soumission.

La REST API et le serveur MCP partagent un modèle simple : un téléphone est un emplacement, un compte social lié est un compte, et une tâche vidéo est une soumission. Comptes et soumissions fonctionnent sur TikTok, Instagram et YouTube.

Emplacement

Un UUID pour un téléphone attribué.

Compte

Un compte de plateforme, éventuellement lié à un téléphone ; la publication nécessite un compte actif sur son téléphone.

Soumission

Une tâche vidéo dont le statut peut être interrogé.

Les identifiants de compte sont des UUID. Les outils de téléphone utilisent l'UUID d'emplacement renvoyé par list-phones-tool, et non l'étiquette visible par les personnes. Une soumission doit cibler un compte actif sur son téléphone. La plupart des actions de plateforme et des actions qui touchent au téléphone sont mises en file d'attente et renvoient immédiatement une réponse. phone-control-tool, phone-snapshot-tool et phone-ocr-tool renvoient une réponse synchrone. Interrogez les ressources de compte ou de soumission pour suivre les tâches en file d'attente.

Trois interfaces. Choisissez votre arme.

Utilisez REST lorsque votre application a besoin d'un contrat HTTP stable. Utilisez MCP lorsqu'un client IA doit découvrir des outils et agir avec OAuth dans un navigateur. Utilisez le tableau de bord ou le contrôle par navigateur lorsqu'une personne doit inspecter l'écran réel.

Pour les systèmes

REST API

Créez des comptes, listez les comptes, mettez des soumissions en file d'attente et interrogez le statut avec des requêtes HTTP à jeton Bearer.

Ouvrir la référence de l'API
Pour les clients IA

Serveur MCP

Donnez à Claude Code, Claude Desktop, Cursor, Codex ou n'importe quel client MCP la boîte à outils complète : comptes, soumissions, facturation, imports et contrôle direct des téléphones.

$ claude mcp add --transport http 0bull https://0bull.net/mcp
Voir les options de connexion
Pour les opérateurs

Contrôle depuis le navigateur

Mettez un VA ou un opérateur sur l'écran du téléphone en direct dès qu'un humain doit relire une publication ou répondre à une invite.

Voir le flux de l'opérateur

Authentifiez-vous et soumettez. Puis observez et vérifiez.

Commencez par authentifier l'interface utilisée par votre client. Les clients REST créent un jeton API dans les paramètres, le copient une fois et l'envoient comme jeton Bearer. Les clients MCP ajoutent l'URL du serveur HTTP et s'autorisent dans un navigateur via OAuth. Aucun de ces modèles d'identité ne donne accès aux comptes ou aux autorisations téléphoniques d'un autre utilisateur.

Ensuite, listez les comptes ou les téléphones auxquels vous avez accès. Choisissez un compte par son UUID ou un téléphone par l'UUID de son emplacement, mettez une soumission en file d'attente pour un compte actif, puis interrogez la ressource renvoyée jusqu'à son statut final.

  1. Authentifiez le client.
  2. Trouvez un compte ou un téléphone attribué.
  3. Mettez une soumission en file d'attente, importez le média via l'URL d'import signée si besoin, et utilisez l'outil de téléphone approprié ; interrogez la soumission pour suivre le travail en file.
  4. Interrogez le statut et faites intervenir une personne lorsque la plateforme le demande.
REST API : lister les comptescurl
curl https://0bull.net/api/v1/accounts \
  -H "Authorization: Bearer $OBULL_TOKEN" \
  -H "Accept: application/json"
MCP : ajouter le serveur HTTPjson
{
  "mcpServers": {
    "0bull": {
      "type": "http",
      "url": "https://0bull.net/mcp"
    }
  }
}

Cloisonné et sécurisé. Facile à planifier.

Accès limité
Chaque jeton API et chaque autorisation MCP sont limités au compte qui les a créés. Les appels MCP ne voient que les comptes de l'appelant et n'accèdent qu'aux téléphones pour lesquels celui-ci dispose d'une autorisation.
Relais humain intégré
Quand une tâche exige une personne devant l'appareil, le statut de la soumission l'indique, et votre flux de travail confie le téléphone à un opérateur.
Des limites de débit claires
REST et MCP autorisent 60 requêtes par minute. L'interrogation est prévue : espacez vos appels de statut pendant que le téléphone travaille.

Référence des outils MCP

Une véritable interface d'outils. Organisée par tâche.

Chaque outil que reçoit votre agent, regroupé par tâche. Les paramètres complets et les formats de réponse sont dans la référence.

Comptes

Créez et inspectez les comptes de publication utilisés par vos automatisations.

  • list-accounts-tool

    Listez les comptes TikTok, Instagram et YouTube.

  • get-account-tool

    Récupérez un compte de publication, sur n'importe quelle plateforme.

  • create-account-tool

    Liez un compte de publication déjà connecté sur un téléphone.

  • delete-account-tool

    Remove an account from 0bull without deleting it on its platform.

Soumissions et imports

Faites passer le média dans le flux de publication et observez le résultat.

  • list-submissions-tool

    Listez les soumissions récentes sur les plateformes prises en charge.

  • get-submission-tool

    Récupérez une soumission et interrogez son statut.

  • create-upload-url-tool

    Créez une URL signée à courte durée de validité pour importer directement une vidéo.

  • create-submission-tool

    Mettez en file une vidéo depuis une URL publique ou un média importé pour un compte.

  • cancel-submission-tool

    Annuler une soumission en file d'attente ou en cours.

  • delete-submission-tool

    Supprimez une soumission terminée et la vidéo enregistrée correspondante.

Téléphones

Inspectez et utilisez directement un emplacement téléphonique attribué.

  • list-phones-tool

    Listez les emplacements téléphoniques que vous pouvez consulter avec l'état de leur session.

  • list-phone-runs-tool

    Listez les exécutions d'un téléphone, des plus récentes aux plus anciennes.

  • get-phone-run-tool

    Récupérez une exécution par son identifiant.

  • phone-command-tool

    Exécutez des commandes d'appareil comme le presse-papiers, les URL, l'alimentation et les actions de connectivité.

  • phone-control-tool

    Envoyez directement des appuis, balayages, raccourcis clavier et saisies de texte.

  • phone-snapshot-tool

    Capturez un instantané JPEG de l'écran du téléphone.

  • phone-ocr-tool

    Lisez le texte de l'écran d'un téléphone avec l'OCR.

  • run-macro-tool

    Exécutez un flux nommé ou une séquence brute d'étapes téléphoniques.

  • run-phone-agent-tool

    Donnez à l'agent IA du téléphone une tâche en langage courant et laissez-le faire.

Facturation et locations

Consultez les locations et demandez des modifications du nombre de téléphones avec une approbation humaine dans la boucle.

  • get-billing-tool

    Consultez les locations de téléphones, les dates de renouvellement et les commandes en attente.

  • start-rental-tool

    Renvoyez un lien Stripe Checkout pour une première commande de téléphone.

  • request-phones-tool

    Demandez une modification du nombre de téléphones loués.

  • get-billing-request-tool

    Consultez le statut d'une demande de modification du nombre de téléphones.

Questions de développeurs. Réponses claires.

Non. 0bull exécute l'application native sur un iPhone physique et publie depuis le téléphone, exactement comme une personne le ferait dans l'application. La REST API et le serveur MCP sont la façon dont vous pilotez ces téléphones.

REST est une API HTTP à jeton Bearer pour les comptes et les soumissions. MCP est un serveur authentifié par OAuth pour un client MCP, avec une interface d'outils plus large qui couvre aussi les imports, la facturation et les opérations directes sur les téléphones.

Les comptes utilisent des UUID et identifient leur propre plateforme. Les outils de téléphone utilisent l'UUID d'emplacement renvoyé par list-phones-tool. L'étiquette visible par les personnes n'est pas l'identifiant à transmettre à un outil de téléphone.

Elle est mise en file d'attente pour son téléphone. Interrogez la ressource de soumission et lisez son statut pour savoir quand la vidéo est publiée.

Oui. Ouvrez le téléphone dans le navigateur et prenez la main : relectures, travail manuel à l'écran, tout ce qu'un VA ou un coéquipier doit voir.

La référence de l'API couvre l'authentification Bearer, la pagination, les codes de réponse et les erreurs de validation. Les pages de connexion et de présentation de MCP couvrent OAuth, la limitation de portée, le travail asynchrone et les limites de débit.

Votre prochaine étape.
Déjà entre vos mains.

Choisissez un pays. Nous attribuons le téléphone. À vous de jouer ensuite.

Commander un téléphone
Nous contacter