Comment utiliser nos scripts dans Apple Shortcuts How to use our scripts in Apple Shortcuts
Suivez ces instructions simples pour intégrer nos scripts PHP dans vos raccourcis Apple. Ce guide vous montrera étape par étape comment configurer vos Shortcuts pour utiliser nos API.
Follow these simple instructions to integrate our PHP scripts into your Apple shortcuts. This guide will show you step by step how to configure your Shortcuts to use our APIs.
Principe de base
Basic Principle
La procédure présentée dans ce guide est la même pour tous nos scripts. Elle consiste à: 1) demander une entrée à l'utilisateur, 2) envoyer cette entrée à notre API, et 3) afficher le résultat. En apprenant à maîtriser davantage les Shortcuts, vous pourrez faire des merveilles avec nos scripts!
The procedure presented in this guide is the same for all our scripts. It consists of: 1) asking for user input, 2) sending this input to our API, and 3) displaying the result. As you learn to master Shortcuts, you'll be able to do wonders with our scripts!
Ajouter une demande d'entrée
Add an Input Request
À partir de votre raccourci vide, ajoutez d'abord une action "Demander une entrée" (Ask for Input). Cette action permettra à l'utilisateur de fournir le texte ou la valeur à envoyer à notre script. Tapez sur le bouton "+" puis recherchez "Demander" dans la barre de recherche.
Starting with your empty shortcut, first add an "Ask for Input" action. This action will allow the user to provide the text or value to send to our script. Tap the "+" button and search for "Ask" in the search bar.
Ajouter "Obtenir le contenu d'un URL"
Add "Get Contents of URL"
Ajoutez ensuite l'action "Obtenir le contenu d'un URL" (Get Contents of URL). Effacez la variable qui est déjà dans le champ URL pour y mettre l'URL de votre script. Vous trouverez cette URL dans votre tableau de bord. L'URL devrait ressembler à ceci:
Next, add the "Get Contents of URL" action. Clear the variable that is already in the URL field and enter your script's URL. You can find this URL in your dashboard. The URL should look like this:
https://magicsplitter.fr/api/script_name.php?uuid=your_uuid&value=test
Insérer la variable d'entrée
Insert the Input Variable
Dans l'URL de votre script, remplacez "test" par la variable d'entrée "Input". Pour cela, supprimez le mot "test" après "value=" et tapez sur le bouton de variable (il ressemble à %) puis sélectionnez la variable "Input" créée à l'étape 1.
In your script URL, replace "test" with the "Input" variable. To do this, delete the word "test" after "value=" and tap on the variable button (it looks like %) then select the "Input" variable created in step 1.
Astuce
Tip
L'URL finale devrait ressembler à ceci:
The final URL should look like this:
https://magicsplitter.fr/api/script_name.php?uuid=your_uuid&value=[variable
Input]
où [variable Input] est remplacé par l'icône de la variable.
where [variable Input] is replaced by the variable icon.
Afficher le résultat
Show the Result
Pour terminer, ajoutez une action "Afficher le résultat" (Show Result) pour voir la réponse du serveur. Cette action affichera le contenu renvoyé par notre script après traitement de votre entrée.
Finally, add a "Show Result" action to see the server's response. This action will display the content returned by our script after processing your input.
Tester votre raccourci
Test Your Shortcut
Appuyez sur le bouton de lecture (▶️) en bas à droite pour tester votre raccourci. L'application vous demandera une entrée, puis enverra cette entrée à notre serveur et affichera le résultat du traitement.
Press the play button (▶️) in the bottom right to test your shortcut. The app will ask for an input, then send this input to our server and display the processing result.
Félicitations!
Congratulations!
Vous venez de créer votre premier raccourci utilisant nos API. Ce principe de base est le même pour tous nos scripts. En apprenant à maîtriser davantage les Shortcuts, vous pourrez créer des automatisations encore plus puissantes!
You've just created your first shortcut using our APIs. This basic principle is the same for all our scripts. As you learn to master Shortcuts, you'll be able to create even more powerful automations!
Conseils supplémentaires
Additional Tips
Vous pouvez ajouter autant d'actions que vous voulez après "Obtenir le contenu d'un URL". Par exemple, vous pouvez traiter le résultat avec l'action "Définir une variable" puis l'utiliser ailleurs dans votre raccourci.
You can add as many actions as you want after "Get Contents of URL". For example, you can process the result with the "Set Variable" action and then use it elsewhere in your shortcut.
Créez un widget pour votre raccourci afin de l'exécuter rapidement depuis votre écran d'accueil. Appuyez longuement sur l'écran d'accueil, puis sur "+" et recherchez "Raccourcis".
Create a widget for your shortcut to run it quickly from your home screen. Long press on the home screen, then tap "+" and search for "Shortcuts".
Intégrez vos raccourcis avec Siri en lui disant "Hey Siri, exécute [nom de votre raccourci]" pour des interactions mains libres.
Integrate your shortcuts with Siri by saying "Hey Siri, run [your shortcut name]" for hands-free interactions.
Au lieu d'utiliser "Demander une entrée", vous pouvez aussi utiliser le menu de partage. Cela vous permet de traiter du texte ou des images directement depuis d'autres applications.
Instead of using "Ask for Input", you can also use the share menu. This allows you to process text or images directly from other applications.