Aperçu seulement — activation requise

Téléchargements de construction avec Social Video Saver

Les informations d'identification de production restent désactivées jusqu'à ce que le cas d'utilisation proposé passe une révision de support.

SocialSaverWorkspaceJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

Une vue multi-source présente ensuite un point de terminaison de client affecté et explique un chemin d'appel uniquement pour le serveur.

URL du locatairehttps://socialvideosaver.com

AuthentificationX-API-Key: pending_activation_…

Profil du clientSocialSaverWorkspace

Version de l'APIv1

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

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

Il ne montre aucun bundle client qui s'intègre à côté et ne masque aucun journal public ou dépôt.

Résoudre un lien

La détection de la source est le point de départ de l'opération Resolve sur SocialVideoSaver.Une vue multi-source présente ensuite les formats à partir d'une URL soumise et explique aucune sortie inventée.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`social_url`	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
}

Il montre la disponibilité par lien à côté et ne masque pas l'étiquette de qualité de la vidéo, ce qui est un avantage.

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

SocialVideoSaver aborde la création de tâches par le biais d'une préparation asynchrone, puis d'une courte requête HTTP.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`social_url`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`media_profile`	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://socialvideosaver.com/v1/jobs \
  -H "X-API-Key: $SVS_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'

1202 AcceptéesEnregistrer delivery_job.

2État du sondageGET /v1/jobs/{delivery_job} 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://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
  -H "X-API-Key: $SVS_WORKSPACE_KEY"

SocialVideoSaver organise le polling des jobs autour d’une attente initiale d’une seconde. Sa vue multi-source compare le backoff plafonné.

Les erreurs prévisibles

Dans SocialVideoSaver, une enveloppe non 2xx vient en premier lors de l'explication du contrat d'erreur.Cette vue multi-source suit avec un ID de demande de support et se ferme sur la gestion prévisible du client.

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

SocialVideoSaver évalue la demande projetée inter-réseaux avant d'attribuer des limites à l'intégration approuvée.

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.

L'activation avant l'exploration est le point de départ pour l'accès au schéma sur SocialVideoSaver.Une vue multi-source présente ensuite l'authentification attribuée et explique les formes de requête documentées.

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

Activer par le biais du support

Résumez le produit inter-réseaux, la demande mensuelle projetée et chaque fournisseur social concerné. SocialVideoSaver active uniquement les capacités d'analyse ou de travail demandées et stocke un hachage au lieu du jeton.

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