[{"data":1,"prerenderedAt":421},["ShallowReactive",2],{"page:\u002Fintegration\u002Fobtenir-un-lien":3},{"id":4,"title":5,"body":6,"description":411,"download":412,"extension":413,"meta":414,"navigation":415,"path":416,"section":417,"seo":418,"sourceTitle":412,"sourceUpdatedAt":412,"sourceUrl":412,"stem":419,"version":412,"__hash__":420},"docs\u002Fintegration\u002Fobtenir-un-lien.md","Obtenir un lien de téléchargement",{"type":7,"value":8,"toc":403},"minimark",[9,14,61,66,137,141,173,177,243,250,292,302,337,344,348,358,399],[10,11],"api-endpoint",{"endpoint":12,"method":13},"https:\u002F\u002Fapi.raydocs.com\u002Fworkspaces\u002F{WORKSPACE_ID}\u002Fworkflows\u002F{WORKFLOW_ID}\u002Fruns\u002F{RUN_ID}\u002Ffile?file_id={FILE_ID}","GET",[15,16,17,39,54],"doc-callout",{},[18,19,20,35,36,34],"p",{},[21,22,23,24,29,30,34],"strong",{},"Cet appel est facultatif lorsque le ",[25,26,28],"a",{"href":27},"\u002Fintegration\u002Frecuperer-le-resultat","résultat"," contient déjà ",[31,32,33],"code",{},"download_url","."," Utilisez-le pour renouveler un lien expiré ou demander le lien d’un fichier dont vous avez conservé le ",[31,37,38],{},"file_id",[18,40,41,42,46,47,50,51,53],{},"Il s’applique aussi aux pièces reçues dans une ",[25,43,45],{"href":44},"\u002Fintegration\u002Fnotifications","notification"," : conservez son ",[31,48,49],{},"run_id"," et le ",[31,52,38],{}," de la pièce.",[18,55,56,57,34],{},"Cet appel ne relance pas le traitement. Utilisez le ",[25,58,60],{"href":59},"\u002Fintegration\u002Fauthentification","token API",[62,63,65],"h2",{"id":64},"paramètres-du-chemin","Paramètres du chemin",[67,68,69,88],"table",{},[70,71,72],"thead",{},[73,74,75,79,82,85],"tr",{},[76,77,78],"th",{},"Paramètre",[76,80,81],{},"Type",[76,83,84],{},"Obligatoire",[76,86,87],{},"Description",[89,90,91,108,123],"tbody",{},[73,92,93,99,102,105],{},[94,95,96],"td",{},[31,97,98],{},"WORKSPACE_ID",[94,100,101],{},"Identifiant",[94,103,104],{},"Oui",[94,106,107],{},"Espace de travail fourni par Raydocs.",[73,109,110,115,118,120],{},[94,111,112],{},[31,113,114],{},"WORKFLOW_ID",[94,116,117],{},"UUID",[94,119,104],{},[94,121,122],{},"Workflow configuré pour votre intégration.",[73,124,125,130,132,134],{},[94,126,127],{},[31,128,129],{},"RUN_ID",[94,131,117],{},[94,133,104],{},[94,135,136],{},"Identifiant retourné lors de l’envoi des documents.",[62,138,140],{"id":139},"paramètre-de-requête","Paramètre de requête",[67,142,143,155],{},[70,144,145],{},[73,146,147,149,151,153],{},[76,148,78],{},[76,150,81],{},[76,152,84],{},[76,154,87],{},[89,156,157],{},[73,158,159,163,165,167],{},[94,160,161],{},[31,162,38],{},[94,164,117],{},[94,166,104],{},[94,168,169,170,34],{},"Identifiant du fichier référencé dans le résultat, distinct de ",[31,171,172],{},"reference_piece",[62,174,176],{"id":175},"exemple-de-requête","Exemple de requête",[178,179,184],"pre",{"className":180,"code":181,"language":182,"meta":183,"style":183},"language-bash shiki shiki-themes material-theme-lighter github-light github-dark","curl --fail-with-body --get \"https:\u002F\u002Fapi.raydocs.com\u002Fworkspaces\u002F{WORKSPACE_ID}\u002Fworkflows\u002F{WORKFLOW_ID}\u002Fruns\u002F{RUN_ID}\u002Ffile\"   -H \"Authorization: Bearer {RAYDOCS_API_TOKEN}\"   -H \"Accept: application\u002Fjson\"   --data-urlencode \"file_id={FILE_ID}\"\n","bash","",[31,185,186],{"__ignoreMap":183},[187,188,191,195,199,202,206,210,213,216,218,221,223,225,227,230,232,235,237,240],"span",{"class":189,"line":190},"line",1,[187,192,194],{"class":193},"sbgvK","curl",[187,196,198],{"class":197},"stzsN"," --fail-with-body",[187,200,201],{"class":197}," --get",[187,203,205],{"class":204},"sjJ54"," \"",[187,207,209],{"class":208},"s_sjI","https:\u002F\u002Fapi.raydocs.com\u002Fworkspaces\u002F{WORKSPACE_ID}\u002Fworkflows\u002F{WORKFLOW_ID}\u002Fruns\u002F{RUN_ID}\u002Ffile",[187,211,212],{"class":204},"\"",[187,214,215],{"class":197},"   -H",[187,217,205],{"class":204},[187,219,220],{"class":208},"Authorization: Bearer {RAYDOCS_API_TOKEN}",[187,222,212],{"class":204},[187,224,215],{"class":197},[187,226,205],{"class":204},[187,228,229],{"class":208},"Accept: application\u002Fjson",[187,231,212],{"class":204},[187,233,234],{"class":197},"   --data-urlencode",[187,236,205],{"class":204},[187,238,239],{"class":208},"file_id={FILE_ID}",[187,241,242],{"class":204},"\"\n",[62,244,246,247],{"id":245},"réponse-200-ok","Réponse — ",[31,248,249],{},"200 OK",[178,251,255],{"className":252,"code":253,"language":254,"meta":183,"style":183},"language-json shiki shiki-themes material-theme-lighter github-light github-dark","{\n  \"url\": \"https:\u002F\u002Fapi.raydocs.com\u002F...\"\n}\n","json",[31,256,257,263,286],{"__ignoreMap":183},[187,258,259],{"class":189,"line":190},[187,260,262],{"class":261},"sP7_E","{\n",[187,264,266,270,274,276,279,281,284],{"class":189,"line":265},2,[187,267,269],{"class":268},"s39Yj","  \"",[187,271,273],{"class":272},"sseR_","url",[187,275,212],{"class":268},[187,277,278],{"class":261},":",[187,280,205],{"class":204},[187,282,283],{"class":208},"https:\u002F\u002Fapi.raydocs.com\u002F...",[187,285,242],{"class":204},[187,287,289],{"class":189,"line":288},3,[187,290,291],{"class":261},"}\n",[18,293,294,295,297,298,301],{},"Le champ ",[31,296,273],{}," contient le nouveau lien signé, valide ",[21,299,300],{},"dix minutes",". Téléchargez avec cette valeur telle quelle, sans token API et en suivant les redirections.",[178,303,305],{"className":180,"code":304,"language":182,"meta":183,"style":183},"# DOWNLOAD_URL : valeur url retournée par \u002Ffile\ncurl --fail --location \"$DOWNLOAD_URL\" --output .\u002Fdecision.pdf\n",[31,306,307,313],{"__ignoreMap":183},[187,308,309],{"class":189,"line":190},[187,310,312],{"class":311},"sutJx","# DOWNLOAD_URL : valeur url retournée par \u002Ffile\n",[187,314,315,317,320,323,325,329,331,334],{"class":189,"line":265},[187,316,194],{"class":193},[187,318,319],{"class":197}," --fail",[187,321,322],{"class":197}," --location",[187,324,205],{"class":204},[187,326,328],{"class":327},"su5hD","$DOWNLOAD_URL",[187,330,212],{"class":204},[187,332,333],{"class":197}," --output",[187,335,336],{"class":208}," .\u002Fdecision.pdf\n",[18,338,339,340,343],{},"Un identifiant inconnu ou non accessible pour ce traitement renvoie ",[31,341,342],{},"404",". Un lien renouvelé ne garantit pas qu’un fichier existe encore dans le stockage.",[62,345,347],{"id":346},"disponibilité-temporaire-et-renouvellement","Disponibilité temporaire et renouvellement",[18,349,350,351,354,355,34],{},"Les fichiers sont disponibles ",[21,352,353],{},"temporairement",". Téléchargez-les et conservez-les dans votre logiciel métier dès que le traitement est ",[31,356,357],{},"completed",[359,360,361,365,378,381,387],"ul",{},[362,363,364],"li",{},"Les fichiers finissent par expirer définitivement. Après cette expiration, ils ne sont plus téléchargeables, même en demandant un nouveau lien.",[362,366,367,368,371,372,374,375,377],{},"L'expiration du lien de téléchargement (10 minutes) et celle du fichier sont distinctes. Si le lien expire, rappeler ",[31,369,370],{},"\u002Ffile"," avec les mêmes ",[31,373,129],{}," et ",[31,376,38],{}," pour en obtenir un nouveau, sans relancer le workflow.",[362,379,380],{},"Demander une nouvelle URL ne prolonge pas la conservation du fichier. Un fichier supprimé n'est pas restauré par le renouvellement du lien.",[362,382,383,384,386],{},"Un identifiant de fichier inconnu pour le run entraîne une réponse ",[31,385,342],{},". Le téléchargement peut également échouer si le fichier n'est plus disponible.",[362,388,389,390,392,393,395,396,398],{},"Conserver les liens confidentiels : leur signature permet l'accès au fichier pendant leur validité. Ne pas les enregistrer comme références durables.\nEn cas d'échec de téléchargement d'une pièce, conserver le JSON, le ",[31,391,129],{},", sa ",[31,394,172],{}," et son ",[31,397,38],{}," pour reprendre uniquement ce téléchargement. Un nouvel appel au webhook crée un nouveau run ; il ne doit pas servir à renouveler un lien.",[400,401,402],"style",{},"html pre.shiki code .sbgvK, html code.shiki .sbgvK{--shiki-light:#E2931D;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .stzsN, html code.shiki .stzsN{--shiki-light:#91B859;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s39Yj, html code.shiki .s39Yj{--shiki-light:#39ADB5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sseR_, html code.shiki .sseR_{--shiki-light:#9C3EDA;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sutJx, html code.shiki .sutJx{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#6A737D;--shiki-dark-font-style:inherit}html pre.shiki code .su5hD, html code.shiki .su5hD{--shiki-light:#90A4AE;--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":183,"searchDepth":265,"depth":265,"links":404},[405,406,407,408,410],{"id":64,"depth":265,"text":65},{"id":139,"depth":265,"text":140},{"id":175,"depth":265,"text":176},{"id":245,"depth":265,"text":409},"Réponse — 200 OK",{"id":346,"depth":265,"text":347},"GET — Obtenir ou renouveler le lien signé d’un fichier.",null,"md",{},true,"\u002Fintegration\u002Fobtenir-un-lien","Intégration au logiciel métier",{"title":5,"description":411},"integration\u002Fobtenir-un-lien","oiGIpIrB-41UKAaI2Zyx8qV8u5BGqAbc4Sv9nPVry70",1791469624660]