Aller au contenu
Sur cette page

Documentation / Déménagement

Déménagez votre ville en dix minutes

Collez une clé Fivemanage en lecture seule. On copie chaque capture, clip et son, et on vous remet la liste de ce que devient chaque ancien lien. Rien ne change ni ne disparaît chez Fivemanage : vous pouvez revenir à tout moment.

  1. Collez votre clé

    La lecture seule suffit. Elle est chiffrée pendant le déménagement et supprimée à la fin.

  2. On copie tout

    Chaque fichier, avec son dossier et son nom. Les fichiers identiques ne sont stockés qu’une fois : vous payez ce que vous avez vraiment.

  3. Vous recevez la liste des liens

    Un tableau de chaque ancien lien et du nouveau qui le remplace. Servez-vous-en pour rechercher et remplacer les liens dans vos scripts et votre base.

Pour la plupart des scripts, une nouvelle URL et une clé suffisent

FiveDock répond aux mêmes adresses d’envoi que Fivemanage. screenshot-basic et tout script dont vous pouvez régler l’URL d’envoi continuent de fonctionner une fois l’URL et la clé changées. Quelques-uns, comme lb-phone, ont l’adresse de Fivemanage intégrée à leur code sous escrow et demandent une petite modification.

Toutes les adresses auxquelles nous répondons

Remplacez l’URL de base de Fivemanage par https://api.fivedock.dev, et la clé par un token d’API (fd_live_…) de la page Tokens. Les chemins, les noms de champs et les réponses gardent leur forme.

Lua
-- before
Config.Upload = {
  url = 'https://api.fivemanage.com/api/v3/file',
  key = 'your-fivemanage-key',
}

-- after: the same path on our host, and an API token from Tokens
-- (fd_live_…, not the fda_live_ agent key from server.cfg)
Config.Upload = {
  url = 'https://api.fivedock.dev/api/v3/file',
  key = 'fd_live_…',
}
Adresses de l’API d’envoi
AdresseScopeCe qu’elle fait
Fichiers
POST /api/v3/fileScope · files:writeEnvoie un fichier en multipart/form-data.
POST /api/v3/file/base64Scope · files:writeEnvoie un fichier encodé en base64 dans un corps JSON.
POST /api/v3/file/archiveScope · files:writeEnvoie un .zip ou un .rar et stocke chaque fichier qu’il contient. Propre à FiveDock.
GET /api/v3/fileScope · files:readListe vos fichiers, page par page.
GET /api/v3/file/{id}Scope · files:readLit le détail d’un fichier.
DELETE /api/v3/file/{id}Scope · files:deleteSupprime un fichier.
Liens d’envoi
GET /api/v3/file/presigned-urlScope · files:writeCrée un lien d’envoi à usage unique. Il dure 15 minutes, sauf si vous demandez moins ou plus.
POST /api/v3/file/presigned-url/{ticket}Scope · Aucun, le lien sert d’identifiantEnvoie par un lien créé ci-dessus, sans token.
GET /api/v2/presigned-urlScope · files:writeCrée un lien d’envoi à l’ancienne. Il dure 5 minutes, sauf si vous demandez moins ou plus.
POST /api/v2/presigned-url/{ticket}Scope · Aucun, le lien sert d’identifiantEnvoie par un lien créé à l’ancienne, sans token.
Fivemanage v2
POST /api/v2/imageScope · files:writeEnvoie une image. Le fichier va dans le champ image ou dans file.
POST /api/v2/videoScope · files:writeEnvoie une vidéo. Le fichier va dans le champ video ou dans file.
POST /api/v2/audioScope · files:writeEnvoie un son. Le fichier va dans le champ audio ou dans file.
Fivemerr
POST /v1/media/imagesScope · files:writeEnvoie une image. Le fichier va dans file ou data.
POST /v1/media/videosScope · files:writeEnvoie une vidéo. Le fichier va dans file ou data.
POST /v1/media/audiosScope · files:writeEnvoie un son. Le fichier va dans file ou data.
Logs
POST /api/logsScope · logs:writeEnvoie un événement de log.
POST /api/logs/batchScope · logs:writeEnvoie des événements de log par lot.
POST /api/v3/logsScope · logs:writeEnvoie des logs à l’adresse v3 de Fivemanage.

Seules ces adresses répondent. Si un script en appelle une qui n’est pas listée, comme l’ancienne /api/image, faites-le pointer vers l’adresse correspondante ci-dessus.

Champs, liens d’envoi, limites et erreurs dans la référence de l’API d’envoi

Ce qu’on ne promettra pas

Les anciens liens pointent vers une adresse qui appartient à Fivemanage, pas à nous : on ne peut donc pas les rediriger de nous-mêmes. C’est à ça que sert la liste.