Aller au contenu
0bull
Commencer gratuitement

Plateforme pour développeurs

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

L'API de publication sur les réseaux sociaux pour développeurs relie vos systèmes à de véritables iPhones pour les flux de publication TikTok, Instagram et YouTube. 0bull vous fournit une REST API, un serveur MCP authentifié par OAuth et une interface de navigateur pour la vérification directe.

Commencer gratuitementLire la documentation pour développeurs

Voir le flux d'intégration

Trois objets de base. Emplacement, compte, soumission.

L'API 0bull et le serveur MCP exposent le même modèle de publication de base : un téléphone est un emplacement, un compte social lié est un compte, et une tâche média est une soumission. Les comptes et les soumissions prennent en charge TikTok, Instagram et YouTube. La plateforme par défaut est TikTok, pour la rétrocompatibilité.

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. Utilisez celle qui convient au travail.

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 un autre client MCP accès à l'interface complète des comptes, soumissions, paiements, imports et contrôles téléphoniques.

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

Contrôle depuis le navigateur

Laissez un VA ou un opérateur travailler depuis l'écran du téléphone quand un humain doit vérifier ou gérer une invite de la plateforme.

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.

À partir de là, listez les comptes ou les téléphones auxquels vous pouvez accéder. Sélectionnez un compte avec son UUID ou un téléphone avec l'UUID de son emplacement. Mettez une soumission en file uniquement pour un compte actif. Interrogez ensuite la ressource renvoyée au lieu de considérer une requête acceptée comme un résultat publié.

  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"
    }
  }
}

Le téléphone fait partie du contrat. Concevez en conséquence.

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.
La vérification humaine est prise en charge
Une soumission peut échouer d'une façon qui demande à quelqu'un d'inspecter l'appareil. Le modèle de statuts documenté rend ces états visibles pour que votre flux de travail puisse s'arrêter et passer la main à un opérateur.
Les limites de débit sont documentées
REST et MCP autorisent 60 requêtes par minute. L'interrogation des statuts est prévue, mais laissez du temps entre les appels pendant que le téléphone termine son travail.

Référence des outils MCP

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

Le serveur MCP expose les outils enregistrés dans le serveur 0bull Phone Farm. Utilisez la référence complète pour les paramètres et les formats de réponse ; cette page conserve une vue d'ensemble lisible.

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

    Retirez un compte de la ferme sans le supprimer de sa plateforme.

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

    Demandez à l'agent d'interface sur téléphone d'effectuer une tâche précise de manière asynchrone.

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.

Lisez chaque paramètreVérifier un statut asynchrone

Connaissez les limites. Avant de construire.

Le modèle produit documenté est un flux sur véritable téléphone. 0bull met les actions en file sur l'appareil physique au lieu de présenter le service comme une API directe de publication de plateforme. Les interfaces REST et MCP sont les interfaces de contrôle 0bull de ces flux sur appareil.

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.

La soumission est mise en file pour le téléphone. Interrogez la ressource de soumission et lisez son statut. L'acceptation d'une requête ne signifie pas que la vidéo est publiée.

Oui. La surface navigateur est le chemin de l'opérateur pour le travail à l'écran, la vérification, et les autres actions où un VA ou un coéquipier doit voir l'appareil.

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.

Ouvrir la documentationOpérations téléphoniques pour les agencesFlux TikTok sur appareil

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

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

Commencer gratuitement