{"id":17021240,"url":"https://github.com/cyrillef/forge.commandline-curl","last_synced_at":"2025-07-30T14:33:13.708Z","repository":{"id":18689220,"uuid":"21898898","full_name":"cyrillef/forge.commandline-curl","owner":"cyrillef","description":"Authorization and file translation demo: Demonstrates Autodesk Forge API authorization and translation process using cURL","archived":false,"fork":false,"pushed_at":"2018-10-05T14:52:08.000Z","size":574,"stargazers_count":12,"open_issues_count":4,"forks_count":8,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-12T10:12:49.082Z","etag":null,"topics":["bash","command-line","curl","model-derivative","shell-scripts","viewer"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyrillef.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-16T11:58:57.000Z","updated_at":"2021-08-03T10:53:35.000Z","dependencies_parsed_at":"2022-08-30T21:22:10.799Z","dependency_job_id":null,"html_url":"https://github.com/cyrillef/forge.commandline-curl","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrillef%2Fforge.commandline-curl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrillef%2Fforge.commandline-curl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrillef%2Fforge.commandline-curl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrillef%2Fforge.commandline-curl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyrillef","download_url":"https://codeload.github.com/cyrillef/forge.commandline-curl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248550633,"owners_count":21122934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","command-line","curl","model-derivative","shell-scripts","viewer"],"created_at":"2024-10-14T07:07:10.037Z","updated_at":"2025-04-12T10:12:57.971Z","avatar_url":"https://github.com/cyrillef.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![cUrl](https://img.shields.io/badge/cUrl-7.47.1-blue.svg)](https://nodejs.org/)\n![Platforms](https://img.shields.io/badge/platform-windows%20%7C%20osx%20%7C%20linux-lightgray.svg)\n[![License](http://img.shields.io/:license-mit-blue.svg)](http://opensource.org/licenses/MIT)\n\n*Forge API*:\n[![oAuth2](https://img.shields.io/badge/oAuth2-v1-green.svg)](http://autodesk-forge.github.io/)\n[![Data-Management](https://img.shields.io/badge/Data%20Management-v1-green.svg)](http://autodesk-forge.github.io/)\n[![OSS](https://img.shields.io/badge/OSS-v2-green.svg)](http://autodesk-forge.github.io/)\n[![Model-Derivative](https://img.shields.io/badge/Model%20Derivative-v2-green.svg)](http://autodesk-forge.github.io/)\n[![Viewer](https://img.shields.io/badge/Forge%20Viewer-v6.2-green.svg)](http://autodesk-forge.github.io/)\n\n\n# forge.commandline-curl\n\n\u003cb\u003eNote:\u003c/b\u003e For using this sample, you need a valid oAuth credential.\nVisit this [page](https://developer.autodesk.com) for instructions to get on-board.\n\nDemonstrates the Autodesk Forge API authorisation and translation process using cURL\nin command line scripts.\n\n\n## Description\n\nThis sample exercises the cURL command demonstrating the Forge OAuth authorisation and\nModel Derivatives API mentioned in the Quick Start guide.\n\nIn order to make use of this sample, you need to register your consumer key, of course:\n* https://developer.autodesk.com \u003e My Apps\n\nThis provides the credentials to supply while calling the Forge WEB service API endpoints.\n\n\n## Dependencies\n\nStandard OS functionality, Bash, cURL and JQ.\n\n* http://en.wikipedia.org/wiki/CURL\n* https://en.wikipedia.org/wiki/Bash_(Unix_shell)\n* https://stedolan.github.io/jq/\n\nThis sample targets Mac OSX and Unix only, it should run on different distribution of Linux but was tested\non Ubuntu and Fedora only at this time.\n\nWindows user, you need to install a Unix shell like [cygwin](http://cygwin.com) or [Git for Windows](https://git-scm.com/download/win),\nbut the sample requires bash 3.2 minimum to run. See the Windows special setup instructions for more details.\n\n\n## Setup/Usage Instructions\n\nWindows user, see  Windows special setup instructions below first.\n\n  1. Make sure cURL is installed in your system; if not, please refer to the\n     [cURL releases and downloads](http://curl.haxx.se/download.html).\n  2. Check that cURL is running in a Terminal window:\u003cbr /\u003e\n     ```\n     curl -V\n     ```\n  3. Request your consumer key/secret key from [https://developer.autodesk.com](https://developer.autodesk.com).\n  4. Set 2 environment variables FORGE_CLIENT_ID / FORGE_CLIENT_SECRET to hold your consumer key/secret keys.\n  5. Install JQ\n     ```\n     brew install jq\n     ```\n\n\nThe ./forge scripts provide quick help information for the commands and arguments.\n\nA typical workflow is:\n\n    # Do authentication\n    ./forge 2legged\n\n    # Create a bucket. Bucket name must be lower case and valid characters\n    ./forge bucketCreate my_bucket_name\n\n    # Upload a model\n    ./forge upload samples/Au.obj\n\n    # Translate the model\n    ./forge translate Au.obj\n\n    # Wait until the translation completes.\n    # Translation is complete when it reaches 'success - 100%'\n    ./forge translateProgress Au.obj\n\n    # Retrieve preview image (png saved into ./temp/)\n    ./forge thumbnail Au.obj\n\n    # View the model in your localhost WEB site (html saved into ./temp/)\n    ./forge html Au.obj\n\nNote your access token and bucket name are saved in the data folder to be used as default by the scripts,\nbut you can edit them as you wish.\n\nBucket information (JSON replies) returned by the system is stored in the data folder as well.\n\n\n### Windows special setup instructions\n\nThis sample was tested on Windows with the [git for windows](http://git-for-windows.github.io/) package.\nIt provides a nice terminal windows running Bash v4.3 and cUrl v7.51 already installed.\n\n  1. Go to [http://git-for-windows.github.io/](http://git-for-windows.github.io/) and install the package.\n     Select the default options.\n  2. Go to [https://stedolan.github.io/jq/download/](https://stedolan.github.io/jq/download/), install JQ,\n     and rename it to jq.\n  3. Start the 'Git Bash' Terminal window from the Desktop icon, or a shortcut running this command\n     ``` \"C:\\Program Files\\Git\\git-bash.exe\" --cd-to-home ```\n  4. Put the sample directory into the PATH.\n  5. You can now continue with the normal setup instructions.\n\n\n## License\n\nThis sample is licensed under the terms of the [MIT License](http://opensource.org/licenses/MIT).\nPlease see the [LICENSE](LICENSE) file for full details.\n\n\n## Written by\n\nCyrille Fauvel \u003cbr /\u003e\nForge Partner Development \u003cbr /\u003e\nhttp://developer.autodesk.com/ \u003cbr /\u003e\nhttp://around-the-corner.typepad.com \u003cbr /\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyrillef%2Fforge.commandline-curl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyrillef%2Fforge.commandline-curl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyrillef%2Fforge.commandline-curl/lists"}