Create a Queue
You're ready for this how-to guide if you've got the following:
A FreeClimb account
A registered application
A configured FreeClimb Number
Your tools and language installed
Node.js
Using the FreeClimb SDK, invoke an asynchronous request to create a Queue. Optional Queue parameters such as alias
or maxSize
can be specified during the creation of the Queue. Successful invocation returns the Queue's metadata.
Create your package.json file and save in the root directory of your project:
{
"name": "node-make-a-queue-how-to-guide",
"version": "1.0.0",
"license":"MIT",
"scripts": {
"start": "node makeAQueue.js"
},
"dependencies": {
"@freeclimb/sdk": "^3.4.0",
"dotenv": "^16.3.1"
}
}
Install the package by running the following in the command line/terminal:
yarn install
Example code:
// Imports and setup
require('dotenv').config()
const freeclimbSDK = require('@freeclimb/sdk')
const accountId = process.env.ACCOUNT_ID
const apiKey = process.env.API_KEY
const freeclimb = freeclimbSDK(accountId, apiKey)
const options = {
alias: 'Tutorial Queue',
maxSize: 25
}
//Invoke method to create a queue with the options provided
freeclimb.api.queues.create(options).then(queue => {
// use created queue
const queueId = queue.queueId
freeclimb.api.queues.get(queueId).then(queue => {
console.log(queue)
})
}).catch(err => {
// Catch Errors
})
Java
After successfully creating the FreeClimbClient
, you can invoke QueuesRequester
to send a synchronous request to create a Queue. Optional Queue parameters such as alias
or maxSize
can be specified during the creation of the Queue. Successful invocation returns the Queue's metadata.
Create your build.gradle file and save it to the root directory in your project:
/*
* This file was generated by the Gradle 'init' task.
*
* This is a general purpose Gradle build.
* Learn how to create Gradle builds at https://guides.gradle.org/creating-new-gradle-builds
*/
buildscript {
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
//Add the dependency
dependencies {
classpath "org.springframework.boot:spring-boot-gradle-plugin:2.1.6.RELEASE"
}
}
apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'idea'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'
bootJar {
baseName = 'gs-spring-boot'
version = '0.1.0'
}
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
sourceCompatibility = 1.8
targetCompatibility = 1.8
dependencies {
compile "org.springframework.boot:spring-boot-starter-web"
testCompile "junit:junit"
compile 'com.github.FreeClimbAPI:FreeClimb-Java-SDK:3.0.0'
}
sourceSets {
main {
java {
srcDirs = ['src'] // changed line
}
}
}
Build the file by running the following in your terminal/command line:
gradle build
Example code:
import com.vailsys.freeclimb.api.FreeClimbClient;
import com.vailsys.freeclimb.api.FreeClimbException;
import com.vailsys.freeclimb.api.queue.Queue;
import com.vailsys.freeclimb.api.queue.QueueCreateOptions;
public void makeQueue() {
//Options payload to set alias and maximum size when creating the queue
QueueCreateOptions options = new QueueCreateOptions();
options.setAlias("Tutorial Queue");
options.setMaxSize(25);
try {
//Create FreeClimbClient object
// accountId & api key can be found under API credentials on the FreeClimb Dashboard
FreeClimbClient client = new FreeClimbClient(accountId, apiKey);
//Invoke method to create a queue with the options provided
Queue queue = client.queues.create(options);
} catch (FreeClimbException ex) {
// Exception throw upon failure
}
}
C#
After successfully creating the FreeClimbClient
, you can invoke getQueuesRequester
to send a synchronous request to create a queue. Optional Queue parameters such as alias
or maxSize
can be specified during the creation of the Queue. In this sample the optional alias
is included. Successful invocation returns the Queue's metadata.
Imports used:
using com.freeclimb.api;
using com.freeclimb.api.queue;
Example code:
string alias = "My_First_Queue";
QueueOptions options = new QueueOptions();
options.setAlias(alias); // Set the optional alias
// Create FreeClimbClient object
FreeClimbClient client = new FreeClimbClient(getFreeClimbAccountId(),
getFreeClimbApiKey());
// Invoke method to create queue metadata
Queue queue = client.getQueuesRequester.create(options);
Updated 2 months ago