Index

Use the API to connect with karmacracy

Following you can find karmacracy API index. Here you will find all variables and methods to communicate with karmacracy. If you see that the info you need is not available, please contact us as soon as you can.

Basics

Mode: API calls are REST; very simple and straightforward. They work with JSON. Almost each technology you would want your app to build on, has a library to decode JSON objects. So don't get scared, JSON is easy, really easy.

Endpoint: All endpoints start with http://karmacracy.com/api/, followed by version number and the class you are querying. For example, http://karmacracy.com/api/v1/user/... (to query users).

APPKEY: all requests to API need an "appkey". We give appkeys so that we can disable a malware application if it is informed to us. They are free, so contact us and ask us for one.

Pagination: all requests that send a list back use the same pagination parameters: from & num. From starts with 1, and tells the number of the item to start from. Num tells the number of elements to return back. Defaults for (from,num) are (1,10).

Shorten - kcy.me

Name Description
Shorten a link Public API to short your links from ANYWHERE

Key / Password

Name Description
Key regeneration and recovery Allow people to recover and regenerate their 3rd party key through your app
Check if key is valid Allows application to check if the user and 3rd party app key are valid

Usuario

Name Description
User info Get public user info: data, kcyrank, kcys
User networks Get private information refering to user's networks, so you can use it to share later

Kcy

Name Description
Kcy info Get public kcy info: kcy data, humans, traffic stats
Kcy list Query, search and explore kcys from karmacracy.com
Kcy share Share a kcy to user's networks (twitter, facebook, ...)

Karma

Name Description
Kcyrank list Query and explore the global and instant kcyrank