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.
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'APIServeur 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/mcpContrô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érateurAuthentifiez-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.
- Authentifiez le client.
- Trouvez un compte ou un téléphone attribué.
- 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.
- Interrogez le statut et faites intervenir une personne lorsque la plateforme le demande.
curl https://0bull.net/api/v1/accounts \
-H "Authorization: Bearer $OBULL_TOKEN" \
-H "Accept: application/json"{
"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-toolListez les comptes TikTok, Instagram et YouTube.
get-account-toolRécupérez un compte de publication, sur n'importe quelle plateforme.
create-account-toolLiez un compte de publication déjà connecté sur un téléphone.
delete-account-toolRemove 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-toolListez les soumissions récentes sur les plateformes prises en charge.
get-submission-toolRécupérez une soumission et interrogez son statut.
create-upload-url-toolCréez une URL signée à courte durée de validité pour importer directement une vidéo.
create-submission-toolMettez en file une vidéo depuis une URL publique ou un média importé pour un compte.
cancel-submission-toolAnnuler une soumission en file d'attente ou en cours.
delete-submission-toolSupprimez 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-toolListez les emplacements téléphoniques que vous pouvez consulter avec l'état de leur session.
list-phone-runs-toolListez les exécutions d'un téléphone, des plus récentes aux plus anciennes.
get-phone-run-toolRécupérez une exécution par son identifiant.
phone-command-toolExécutez des commandes d'appareil comme le presse-papiers, les URL, l'alimentation et les actions de connectivité.
phone-control-toolEnvoyez directement des appuis, balayages, raccourcis clavier et saisies de texte.
phone-snapshot-toolCapturez un instantané JPEG de l'écran du téléphone.
phone-ocr-toolLisez le texte de l'écran d'un téléphone avec l'OCR.
run-macro-toolExécutez un flux nommé ou une séquence brute d'étapes téléphoniques.
run-phone-agent-toolDonnez à 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-toolConsultez les locations de téléphones, les dates de renouvellement et les commandes en attente.
start-rental-toolRenvoyez un lien Stripe Checkout pour une première commande de téléphone.
request-phones-toolDemandez une modification du nombre de téléphones loués.
get-billing-request-toolConsultez 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