Orbit Activities Helper Library for Node.js
Orbit API helper library for Node.js.
This client can create, read, update and delete activities in your Orbit workspace.
Installation
npm install @orbit-love/activities
Constructor
const OrbitActivities = require('@orbit-love/activities')
const orbitActivities = new OrbitActivities(orbitWorkspaceId, orbitApiKey)-
orbitWorkspaceId- The part of your Orbit workspace URL that immediately follows the app.orbit.love. For example, if the URL was https://app.orbit.love/my-workspace, then your Orbit workspace ID is my-workspace. -
orbitApiKey- This can be found in you Orbit Account Settings.
Initializing with environment variables
If you have the environment variables ORBIT_WORKSPACE_ID and ORBIT_API_KEY set, you can initialize the client like so:
const OrbitActivities = require('@orbit-love/activities')
const orbitActivities = new OrbitActivities()If you have environment variables set and also pass in values, the passed in values will be used.
Rate Limits & Page Sizes
- Information about Orbit API Rate Limiting
- For list methods, you can ask request a number of results per request between 1 and 100.
Activity Methods
listWorkspaceActivities(options)
const options = {
page: 1,
items: 50,
company: 'ACME Corp'
}
orbitActivities.listWorkspaceActivities(options).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})options is not a required parameter, but can be any query parameter shown in our API reference.
listMemberActivities(memberId, options)
const memberId = 'janesmith04'
const options = {
page: 1,
items: 50
}
orbitActivities.listMemberActivities(memberId, options).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})options is not a required parameter, but can be any query parameter shown in our API reference.
getLatestActivityTimestamp(activityType)
const activityType = 'issued:opened'
orbitActivities.getLatestActivityTimestamp(activityType).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})Will return the timestamp of the latest activity with the provided type, or null if there are none.
getActivity(activityId)
const activityId = '1234536'
orbitActivities.getActivity(activityId).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})createActivity(memberId, data) or createActivity(data)
If you know the memberId for the member you want to add the activity to:
const memberId = 'janesmith04'
const data = {
activity_type: 'starfleet:signup',
title: "New Planet Signed Up for Starfleet",
description: "Klingon has joined Starfleet via Twitter",
member: {
tshirt: 'XL',
twitter: 'qunnoq'
}
}
orbitActivities.createActivity(memberId, data).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})data should match the body params as shown in the Create a post activity for a member API reference.
If you know one or more identities of the member (github, email, twitter, etc.) but not their Orbit ID:
const data = {
activity_type: 'starfleet:signup',
title: "New Planet Signed Up for Starfleet",
description: "Klingon has joined Starfleet via Twitter",
member: {
tshirt: 'XL',
twitter: 'qunnoq'
}
}
orbitActivities.createActivity(data).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})data should match the body params as shown in the Create an activity for a new or existing member API reference.
updateActivity(memberId, activityId, data)
const memberId = 'janesmith04'
const activityId = '1234356'
const data: {
description: 'New description'
}
orbitActivities.updateActivity(memberId, activityId, data).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})data should match the body params as shown in the Update a custom activity for a member API reference.
deleteActivity(memberId, activityId)
const memberId = 'janesmith04'
const activityId = '1234356'
orbitActivities.deleteActivity(memberId, activityId).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})Note Methods
listMemberNotes(memberId, options)
const memberId = 'janesmith04'
const options = {
page: 1
}
orbitActivities.listMemberNotes(memberId, options).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})options is not a required parameter, but can be any query parameter shown in our API reference.
createNote(memberId, body)
const memberId = 'janesmith04'
const body = 'Had a really excellent interview with Jane today.'
orbitActivities.createNote(memberId, body).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})updateNote(memberId, noteId, body)
const memberId = 'janesmith04'
const noteId = '12345'
const body = 'Had a really excellent interview with Jane today. Here is some more info.'
orbitActivities.updateNote(memberId, noteId, body).then(data => {
console.log(data)
}).catch(error => {
console.error(error)
})Contributing
We
License
This is available as open source under the terms of the MIT License.
Code of Conduct
This project uses the Contributor Code of Conduct. We ask everyone to please adhere by its guidelines.