This is the Codebits API (https://codebits.eu/s/api) Node.js Module Wrapper to speed up for development during that 72 hour straight hackathon we know and love!
$ npm install codebitsvar codebits = require('codebits');
codebits.auth.logIn('USERNAME', 'PASSWORD', function (err, token){
// codebits module will cache the token
codebits.users.getUserbyID('USERID', function(err, user){
console.log(user);
});
});
// but if you want to use another auth token, you can
codebits.users.getUserbyID('USERID', anotherToken, function(err, user){
console.log(user);
});
This module was built in a very quick 'hacky' manner, it has tests, which is a good thing, but it is not bullet proof, if you find any bug or a better way to do things, we accept happily pull requests. Big thanks to axfcampos who liked the idea and offered his time to implement several of the functionalities.
requires auth tokenrequires auth tokenCreates a session token that is requested by calls that need auth
call:
codebits.auth.logIn('USERNAME', 'PASSWORD', function (err, token){
// token is a string
});
List of all the existing badges
codebits.badges.listBadges(function (err, reply){
/* each reply array elem:
{
"id": "string", //badge id
"img": "string", //img url
"title": "string", //badge title
"description": "string", //badge description
"usercount": "string" //number of users who have this badge
}
*/
});
List of all the users who have a certain badge
codebits.badges.getBadgeUsers('BADGE_ID', function(err, reply){
/* reply is an array, where each element
{
"uid": "string", //user id
"name": "string", //user name
"nick": "string", //user nick
"proofurl": "string",
"md5mail": "string"
}
*/
});
[Requires authentication!]
Redeem a badge through a badge code
codebits.badges.redeemBadges('BADGE_CODE', function (err, reply){
// if successful reply will be an object with success code and msg
// if not, error code and reason
});
Returns the body parts you can play with to build your bot.
codebits.bots.getBodyParts( function (err, reply){
/* body elem contains array for body parts
{
"body":
[{
"id": "01",
"picker": "\/builder\/avatar_images\/body\/picker\/t-body-01.png",
"file": "\/builder\/avatar_images\/body\/composer\/body-01.png"
},
{ .... }, ....
]
}
*/
});
Returns the bot structure for a certain user
codebits.bots.getUserBot('USER_ID', function (err, reply){
/* example reply object:
{
"bgcolor":0,
"grad":0,
"body":"04",
"eyes":"07",
"mouth":"05",
"legs":"06",
"head":"01",
"arms":"17",
"balloon":false,
"botfile":"\/bots\/39f0e732e0d976c486573f53c687cc9d",
"comments_token":"2a680f5a39bf2e59b60e123cb22fb29611317522"
}
*/
});
Returns the bot image. Request format as follows (example):
var opts = {
body: '01',
bgcolor: null,
grad: '03',
eyes: '04',
mouth: '05',
legs: '06',
head: '07',
arms: '08',
balloon: 'hello world! :-)',
file: '/path/to/save/returned/image.png'
}
Each field has the exact ID (with leading zeros) from getBodyParts.
If you don't want a certain body part to be rendered, use null for the ID. The balloon is optional.
If file: field is null it defaults to /tmp/bot.png.
codebits.bots.makeBot(opts, function (err, res, body){
//the img will be saved to the path, res and body are in original form
});
[requires authentication!]
Sets the bot of the authenticated user.
Format for opts field is the same as makeBot minus the file field.
Returns a success/unsuccess message.
//_token is optional
codebits.bots.setBot(opts, _token, function (err, reply){
/* reply success example:
{ result: 1, user: '3949', msg: 'bot set' } //success
*/
});
Returns this year's codebits calendar with detailed information.
codebits.calendar.getCalendar( function (err, result){
/*
Calendar is an array
check the full object at: https://services.sapo.pt/Codebits/calendar
*/
});
[authentication optional!]
Returns the list of the call for talks submissions for this year. Authentication is optional, returns the user thumb option under 'rated', if provided.
codebits.callfortalks.listSubmissions( function (err, reply){
/* an array where each object is a talk:
{
id: "string",
title: "string",
description: "string",
regdate: "2013-10-25 13:57:08",
up: 'string", //n votes up
down: "string", //n votes down
lang: "en",
user: "string",
userid: "string",
rated: "string",
approved: 1, //if approved
comments_token: "string" //useful to submit comments
}
*/
});
[authentication required!]
Vote up a proposed talk by its id.
//_token is optional
codebits.callfortalks.voteTalkUp('TALK_ID', _token, function (err, reply){
/*
Confirmation object returns the same talk id
{ talk: '100', thumbs: 'up' }
*/
});
[authentication required!]
Vote down a proposed talk by its id.
//_token is optional
codebits.callfortalks.voteTalkDown('TALK_ID', _token, function (err, reply){
/*
Confirmation object returns the same talk id
{ talk: '100', thumbs: 'down' }
*/
});
[requires authentication!]
Posts a new comment on a certain thread identified by the comment_token. Some calls (ie: listSubmission) will provide you with a comments_token field you can use here.
var opts = {
comment_token: '1234asdf1234qwerty',
comment: 'Hello Codebits World!',
subect: 'My Hello Message' //optional
token: authtoken //optional, If not submitted our code will search for it ˆ_ˆ
};
codebits.comment.postComment(opts, function (err, reply){
/*
{ result: 1, msg: 'comment posted' }
*/
});
[requires authentication!]
Returns the list of submitted projects for this year's competition.
//_token is optional
codebits.projects.listProjects(_token, function (err, reply){
/*
returns an array where each object is a project
*/
});
[requires authentication!}
Returns information about a specfic project.
//_token is optional
codebits.ptojects.getProjectInfo('PROJECT_ID', _token, function (err, reply){
/*
reply contains object with project info
*/
});
Returns information about the number of votes for the project being voted at the project's presentation session
codebits.projects.getCurrentVotes( function (err, reply){
/* //example reply obj
{ project: '353', yes: 63, no: 56 }
*/
});
[requires authentication!]
Votes for the current project being presented. 1 for yes (liked it), 0 for no.
//_token is optional
codebits.projects.voteCurrentProject('1', _token, function (err, reply){
/* //confirmation reply object
{ result: 1, project: '353' }
*/
});
[Requires authentication]
Search this year's edition registered users database
//_token is optional
codebits.search.searchByName('nick', _token, function (err, reply){
/* //example reply for nick=celso
[ { id: '1119',
nick: 'Zed_Blade',
name: 'Celso Bem dos Santos',
md5mail: '44c4eb5469934ceebfffe940d72f9521' },
{ id: '1',
nick: 'celso',
name: 'Celso Martinho',
md5mail: '39f0e732e0d976c486573f53c687cc9d' } ]
*/
});
[requires authentication!]
Returns basic user information.
//_token is optional
codebits.users.getUserbyID('ID', _token, function (err, reply){
/*
{ id: 'string',
nick: 'string',
avatar: 'string',
twitter: 'string',
name: 'string',
md5mail: '39f0e732e0d976c486573f53c687cc9d',
checkin_date: 0,
karma: '143',
bio: 'the users bio',
blog: 'string'
coderep: 'string'
status: 'accepted',
badges:
[ '38',
'10' ],
skills:
[ 'api',
'design',
'web' ] }
*/
});
[requires authentication!]
Same as above, uses nick instead of ID.
//_token is optional
codebits.users.getUserbyNick('NICK', _token, function (err, reply){
/*
Same as above!
*/
});
[requires authentication!]
Returns the list of the user's friends. A word about the status: accepted is accepted by both friends, requested is awaiting acceptance on your side, pending is pending acceptance on your friend's side.
//_token is optional
codebits.users.getUserFriends('ID', _token, function (err, reply){
/*
An array of the same objects returned by getUserbyID/Nick
*/
});
[requires authentication!]
Adds or confirms a user as your friend. Requires confirmation at the other end.
//_token is optional
codebits.users.addUserAsFriend('ID', _token, function (err, reply){
/*
*/
});
[requires authentication!]
Rejects a user as your friend. Deletes the pending request at the other end, if it exists.
//_token is optional
codebits.users.rejectUserAsFriend('ID', _token, function (err, reply){
/*
*/
});
[requires authentication!]
Returns the list of accepted users for this year's Codebits. You can filter the list by an optional 'skill'. The list of skills is: php perl ruby python erlang cc cocoa dotnet java javascript css api web embbeded mobile hardware microformats security sysadmin network desktop scala clojure design dbdesign nosql cooking processing max
//_token is optional
codebits.users.listAcceptedUsers('SKILL', _token, function (err, reply){
/*
*/
});
[requires authentication!]
Returns the list of favorite calendar sessions for a user.
//_token is optional
codebits.users.userFavSessions('ID', _token, function (err, reply){
/*
*/
});
The correct API endpoint for user info by nick is not /user, it is /nick instead
FAQs
codebits.eu API module wrapper
The npm package codebits receives a total of 26 weekly downloads. As such, codebits popularity was classified as not popular.
We found that codebits demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
A supply chain attack on Axios introduced a malicious dependency, plain-crypto-js@4.2.1, published minutes earlier and absent from the project’s GitHub releases.
Research
Malicious versions of the Telnyx Python SDK on PyPI delivered credential-stealing malware via a multi-stage supply chain attack.
Security News
TeamPCP is partnering with ransomware group Vect to turn open source supply chain attacks on tools like Trivy and LiteLLM into large-scale ransomware operations.