Vue d’ensemble
Un point d’entrée, une méthode d’authentification, un corps de requête. La surface est volontairement réduite : chaque réglage supplémentaire est une occasion d’erreur dans une chaîne de publication automatisée.
| Champ | Valeur |
|---|---|
| URL de base | https://indexinstantane.com |
| Soumission | POST /api/indexing/submit |
| Historique | GET /api/indexing/history |
| Solde de crédits | GET /api/user/credits |
| En-tête d’authentification | Authorization: Bearer ixfr_<48 caractères hexadécimaux> |
| Content-Type | application/json |
| URL par requête | 1 à 500 |
| Rétention de l’historique | 48 heures |
Il n’y a pas de quota journalier au sens strict : votre débit est borné par votre solde de crédits, acheté une fois, sans reconduction ni date d’expiration.
Authentification
Les endpoints authentifiés acceptent soit une session par cookie, soit une clé d’API en en-tête Bearer. Pour un usage programmatique, utilisez toujours la clé.
- Connectez-vous au tableau de bord.
- Ouvrez Profil → Accès API.
- Cliquez sur Générer une clé. Elle n’est affichée qu’une fois — copiez-la immédiatement.
- Rangez-la dans votre gestionnaire de secrets : variable d’environnement, coffre, ou équivalent. Jamais dans le dépôt de code.
Soumettre des URL (cURL)
La réponse revient immédiatement, avant même que les URL soient parties vers Google :
Soumettre des URL (Node.js)
Soumettre des URL (Python)
Consulter l’historique
Les enregistrements sont conservés 48 heures. L’endpoint d’historique est paginé et renvoie l’état de chaque adresse :
Chaque enregistrement contient l’URL, son état (submitted, indexed ou failed), le moteur visé, les crédits consommés, l’horodatage, et le motif d’échec normalisé le cas échéant.
Gestion des erreurs
| Code | Cause | Action |
|---|---|---|
| 400 | JSON malformé, ou aucune URL valide dans le corps | Validez l’entrée avant l’envoi |
| 401 | Clé d’API absente ou invalide | Vérifiez l’en-tête Authorization |
| 402 | Crédits insuffisants | Rechargez le compte |
| 413 | Plus de 500 URL dans une requête | Découpez la liste en tranches de 500 |
| 429 | Trop de requêtes | Ralentissez et réessayez avec un intervalle croissant |
| 503 | Service d’indexation momentanément indisponible | Réessayez : les URL sont remises en file de notre côté |
Bonnes pratiques
- Envoyez à la publication, pas à chaque enregistrement. Branchez l’appel sur l’événement de publication du CMS, jamais sur la sauvegarde automatique.
- Groupez ce qui peut l’être. 500 URL dans une requête coûtent moins cher et vont plus vite que 500 requêtes d’une URL.
- N’envoyez pas d’URL qui échoueront aux contrôles d’indexabilité. Une page en noindex consomme un crédit sans aucune chance d’aboutir.
- Vérifiez les résultats. L’endpoint d’historique existe pour confirmer que vos envois sont réellement partis, pas seulement acceptés.
- Régénérez la clé aux changements d’équipe, au même titre que n’importe quel autre secret partagé.
Exemple : brancher l’API sur un CMS
Par où commencer
Créez un compte, générez une clé depuis le tableau de bord, et insérez la requête POST dans votre chaîne de publication. L’offre d’entrée, à 5 $ pour 80 crédits, suffit largement à valider l’intégration de bout en bout avant de passer à un volume supérieur.