{"id":19035724,"url":"https://github.com/freeclimbapi/nodejs-sdk","last_synced_at":"2025-04-23T18:54:34.401Z","repository":{"id":40711445,"uuid":"218550846","full_name":"FreeClimbAPI/nodejs-sdk","owner":"FreeClimbAPI","description":"NodeJS SDK for the FreeClimb API","archived":false,"fork":false,"pushed_at":"2025-03-07T20:29:35.000Z","size":1716,"stargazers_count":1,"open_issues_count":1,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-18T04:12:54.434Z","etag":null,"topics":["library","sdk"],"latest_commit_sha":null,"homepage":"","language":null,"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/FreeClimbAPI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-30T14:48:27.000Z","updated_at":"2025-03-07T20:15:05.000Z","dependencies_parsed_at":"2023-02-09T06:31:27.802Z","dependency_job_id":"3e482dc2-70ff-46f4-92a4-235ca52d6bba","html_url":"https://github.com/FreeClimbAPI/nodejs-sdk","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2Fnodejs-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2Fnodejs-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2Fnodejs-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeClimbAPI%2Fnodejs-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FreeClimbAPI","download_url":"https://codeload.github.com/FreeClimbAPI/nodejs-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250496941,"owners_count":21440231,"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":["library","sdk"],"created_at":"2024-11-08T21:51:54.143Z","updated_at":"2025-04-23T18:54:34.371Z","avatar_url":"https://github.com/FreeClimbAPI.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# @freeclimb/sdk\n\n@freeclimb/sdk - the NodeJS client package for the FreeClimb API\n\nFreeClimb is a cloud-based application programming interface (API) that puts the power of the Vail platform in your hands. FreeClimb simplifies the process of creating applications that can use a full range of telephony features without requiring specialized or on-site telephony equipment. Using the FreeClimb REST API to write applications is easy! You have the option to use the language of your choice or hit the API directly. Your application can execute a command by issuing a RESTful request to the FreeClimb API. The base URL to send HTTP requests to the FreeClimb REST API is: /apiserver. FreeClimb authenticates and processes your request.\n\nThis SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:\n\n- API version: 1.0.0\n- Package version:\n- Build package: org.openapitools.codegen.languages.TypeScriptClientCodegen\n  For more information, please visit [https://www.freeclimb.com/support/](https://www.freeclimb.com/support/)\n\n## Installing\n\n```sh\nnpm install @freeclimb/sdk@4.1.1\nor\nyarn add @freeclimb/sdk@4.1.1\n```\n\n## Getting Started\n\n```typescript\nimport freeclimb from \"@freeclimb/sdk\";\n\nconst configuration = freeclimb.createConfiguration({\n  accountId: \"YOUR_ACCOUNT_ID\",\n  apiKey: \"YOUR_API_KEY\",\n});\nconst apiInstance = new freeclimb.DefaultApi(configuration);\n\napiInstance\n  .listApplications()\n  .then((applications) =\u003e console.log(\"got applications\", applications));\n```\n\n## Detailed SDK documentation\n\nFor more details on how to use the individual methods on the sdk - go [here](https://github.com/FreeClimbAPI/nodejs-sdk/blob/master/DefaultApi.md)\n\n## Using PerCL\n\nThe Performance Command Language (PerCL) defines a set of instructions, written in JSON format, that express telephony actions to be performed in response to an event on the FreeClimb platform. FreeClimb communicates with the application server when events associated with the application occur, so the webserver can instruct FreeClimb how to handle such events using PerCL scripts.\nPerCL commands are a part of the model schema and can be serialized into JSON like so:\n\n```typescript\nimport { Say, Play, GetDigits, PerclScript } from \"@freeclimb/sdk\";\n\nconst say = new Say({ text: \"Hello, World\" });\nconst play = new Play({ file: \"Example File\" });\nconst getDigits = new GetDigits({\n  actionUrl: \"Example Action URL\",\n  prompts: [say, play],\n});\nconst perclScript = new PerclScript({ commands: [getDigits] });\n\nconsole.log(perclScript.toJSON());\n```\n\n\u003ca name=\"documentation-for-verify-request-signature\"\u003e\u003c/a\u003e\n\n## Documentation for verifying request signature\n\n- To verify the request signature, we will need to use the verifyRequestSignature method within the Request Verifier class\n\n  RequestVerifier.verifyRequestSignature(requestBody, requestHeader, signingSecret, tolerance)\n\n  This is a method that you can call directly from the request verifier class, it will throw exceptions depending on whether all parts of the request signature is valid otherwise it will throw a specific error message depending on which request signature part is causing issues\n\n  This method requires a requestBody of type string, a requestHeader of type string, a signingSecret of type string, and a tolerance value of type number\n\n  Example code down below\n\n  ```typescript\n  import { RequestVerifier } from \"./utils/RequestVerifier\";\n\n  export function RequestVerifierExample() {\n    const tolerance: number = 5 * 60;\n\n    const requestBody: string =\n      '{\"accountId\":\"YOUR_ACCOUNT_ID\",\"callId\":\"YOUR_CALL_ID\",\"callStatus\":\"YOUR_CALL_STATUS\",\"conferenceId\":null,\"direction\":\"YOUR_CALL_DIRECTION,\"from\":\"FROM_EXAMPLE\",\"parentCallId\":null,\"queueId\":null,\"requestType\":\"YOUR_REQUEST_TYPE\",\"to\":\"TO_EXAMPLE\"}';\n\n    const signingSecret: string = \"YOUR_SIGNING_SECRET\";\n\n    const requestHeader: string =\n      \"t=YOUR_TIMESTAMP,v1=YOUR_HASH_EXAMPLE,v1=YOUR_HASH_EXAMPLE\";\n\n    RequestVerifier.verifyRequestSignature(\n      requestBody,\n      requestHeader,\n      signingSecret,\n      tolerance,\n    );\n  }\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeclimbapi%2Fnodejs-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreeclimbapi%2Fnodejs-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeclimbapi%2Fnodejs-sdk/lists"}