Aperçu seulement — activation requise

Téléchargements de construction avec SaveTK

SaveTK affiche un plan API pour les intégrations d'outils créateurs, mais n'accepte pas l'exécution non authentifiée. L'approbation fournit à la fois la clé et ses limites de fonctionnement.

SaveTkCreatorJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

SaveTK présente trois points pratiques pour l'hôte API. Le premier concerne les identifiants activés par le support. Le flux de sauvegarde couvre ensuite un point de terminaison locataire assigné. Son dernier point est un chemin d'appel réservé au serveur.

URL du locatairehttps://savetk.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientSaveTkCreator

Version de l'APIv1

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

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

SaveTK facilite la sécurité des identifiants à scanner. La page commence par un stockage secret côté serveur, passe à l'absence d'intégration de bundle client, et indique clairement qu'il n'y a pas de journaux publics ni de dépôts.

Résoudre un lien

SaveTK présente trois points pratiques pour l'opération Resolve. Le premier est la détection de la source. Le flux de sauvegarde couvre ensuite les formats d'une URL soumise. Son dernier point est l'absence de sorties inventées.

POST/v1/resolvePortée: résoudre

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

SaveTK rend l'identifiant de format facile à scanner. La page commence par la valeur retournée inchangée, passe à la disponibilité par lien, et indique clairement qu'aucune étiquette de qualité supposée n'est présente.

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

La création de tâche commence par une préparation asynchrone sur SaveTK. Ce workflow d'économie présente ensuite une courte requête HTTP.

POST/v1/jobsPortée: emplois

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

1202 AcceptéesEnregistrer save_task.

2État du sondageGET /v1/jobs/{save_task} 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://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK gère la mise en file d'attente des tâches en identifiant d'abord une attente initiale d'une seconde. Il suit avec un retour en arrière plafonné et maintient la livraison temporaire signée en vue.

Les erreurs prévisibles

Le contrat d'erreur commence par une enveloppe non 2xx sur SaveTK. La vue suivante couvre un ID de demande de support. La page maintient une gestion client prévisible visible.

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

SaveTK définit les allocations de flux de travail de créateur après avoir examiné le trafic attendu et les plateformes de publication dans le périmètre.

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.

SaveTK présente trois points pratiques pour l'accès au Schéma. Le premier est l'activation avant l'exploration. Le flux de sauvegarde couvre ensuite l'authentification assignée. Son dernier point concerne les formes de demande documentées.

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

Activer par le biais du support

Indiquez ce que fait le client SaveTK, combien d'appels il attend et quels services de publication sont essentiels. La revue de support sélectionne ses portées, puis retourne un identifiant non récupérable affiché une seule fois.

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