Aperçu seulement — activation requise

Téléchargements de construction avec Insto

Insto présente un plan d'intégration des médias visuels pour évaluation. L'analyse en direct et les demandes de travail restent indisponibles jusqu'à ce que le support accorde une autorisation limitée au locataire.

InstoMediaJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

Pour l'hôte API, Insto commence avec des identifiants activés par le support. Sa revue de téléchargement associe cela à un point de terminaison locataire assigné et se termine par un chemin d'appel réservé au serveur.

URL du locatairehttps://insto.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientInstoMedia

Version de l'APIv1

# Available only after support activation
export INSTO_MEDIA_TOKEN="issued-after-review"

curl -X POST https://insto.app/v1/resolve \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Insto présente trois points pratiques pour la sécurité des identifiants. Le premier est le stockage secret côté serveur. La revue du téléchargement couvre ensuite l'absence d'intégration de bundle client. Son dernier point est l'absence de journaux ou de dépôts publics.

Résoudre un lien

Pour l'opération Resolve, Insto commence par la détection de la source, puis l'examen du téléchargement avec les formats d'une URL soumise et se termine sans sortie inventée.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`media_source`	URL HTTPS	Oui	Page média publique ou autorisée à analyser.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Insto présente trois points pratiques pour l'identifiant de format. Le premier est la valeur retournée inchangée. La revue de téléchargement couvre ensuite la disponibilité par lien. Son dernier point est l'absence d'étiquette de qualité supposée.

Créer et suivre une tâche de téléchargement

Insto organise la création de Job autour d'une préparation asynchrone. Son examen de téléchargement compare une requête HTTP courte, l'exécution d'un worker bounded reste la vérification finale.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`media_source`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`media_variant`	string	Oui	Un ID exact de la réponse de résolution.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

curl -X POST https://insto.app/v1/jobs \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_source":"https://www.youtube.com/watch?v=VIDEO_ID","media_variant":"18"}'

1202 AcceptéesEnregistrer prepare_id.

2État du sondageGET /v1/jobs/{prepare_id} avec la même clé.

3PrêtOuvrez l'URL de téléchargement signée.

État d ' avancement	Signification	Action du client
`queued`	Admis dans la file d'attente limitée.	Sondage à nouveau avec backoff.
`extracting`	Actualisation des métadonnées source ou de l'itinéraire.	Continuez à voter.
`processing`	Téléchargement, remixage ou fusion.	Afficher la progression du serveur.
`ready`	Téléchargement signé est disponible.	Envoyez l'URL à l'utilisateur.
`failed`	Erreur structurée terminale.	Lire `error_code`. Réessayez seulement quand conseillé.
`expired`	La sortie temporaire a été supprimée.	Créer un nouveau job.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Dans Insto, l'attente initiale d'une seconde vient en premier lors de l'explication de l'interrogation de tâche.

Les erreurs prévisibles

Pour expliquer le contrat d'erreur, Insto sépare une enveloppe non-2xx d'un ID de demande de support.Une revue de téléchargement donne à la gestion prévisible du client sa propre place.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Signification typique	Action
400	URL, corps ou format non valide.	Corrigez la requête. Résolvez à nouveau pour les formats.
401	Clé manquante, invalide, expirée ou de mauvaise portée.	Vérifiez les informations d'identification côté serveur.
403	La politique du locataire ou de la source a rejeté la demande.	Ne contournez pas la politique. Contactez le support.
404	Offre d'emploi inconnue ou expirée.	Créez une nouvelle tâche si nécessaire.
429	Limite de demandes ou de tâches actives atteinte.	Honor `retry_after_seconds`.
503	File d'attente/capacité ou amont temporairement indisponible.	Réessayez avec un décalage et une gigue exponentiels.

Contrat d ' exploitation

Insto adapte les limites d'appel au cas d'utilisation de média visuel et aux réseaux que le client approuvé contactera.

Utilisez une logique d'application idempotente et ne démarrez jamais de tâches en double pour le même clic utilisateur.
Le cache résout brièvement les métadonnées, mais traite toujours les URL de téléchargement signées comme expirant.
Utiliser un décalage exponentiel limité avec gigue pour 429, 503 et erreurs retentables.
Traitez uniquement les médias publics ou les médias auxquels vous êtes autorisé à accéder.Les contrôles DRM et d'accès ne sont pas contournés.
Conservez les ID de requête et les ID de tâche dans des journaux opérationnels privés.

Pour l'accès au schéma, Insto commence par l'activation avant l'exploration.Son examen de téléchargement associe cela à l'authentification attribuée et se termine par des formes de demande documentées.

ACCÈS RÉVISÉ PAR L'OPÉRATEUR

Activer par le biais du support

Décrivez le produit média visuel, l'utilisation mensuelle prévue et les types de publications que vous envisagez de gérer. Insto accorde uniquement les portées d'analyse ou de préparation nécessaires et ne stocke jamais le jeton lisible.

Demande d'activation Les clés sont limitées à la portée du client, révocables et émises via le formulaire de contact.