| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Stop wasting time looking for files and revisions. Connect your Gmail, DriveDropbox, and Slack accounts and in less than 2 minutes, Dokkio will automatically organize all your file attachments. Learn more and claim your free account.

View
 

Rate Limits

Page history last edited by Brandon Geiger 11 years ago

<< Back to Swarm API Documentation

 

Rate limiting

The Swarm API only allows clients to make a limited number of calls in a given hour. The amount of calls you can make in a given hour is referred to as your "CPH" - "Calls per hour." The default CPH for requests with no consumer key designated is 100.

 

Consumer Key

A consumer key is a token that applications consuming swarm data can use to increase their CPH. If you are consistently hitting the limit for your CPH, consider applying for a consumer key. The Basic membership is FREE, and allows you 200 CPH. You can request a consumer key here.

 

To specify a consumer key when making a request, declare a parameter of "consumer_key" in your request (php example):

 

//set arguments

$args=array("swarm_id"=>1058,"count"=>10,"format"=>"JSON","consumer_key"=>"3y5haZB7SSA2E65DhGU7IUZNjHdyKFb");

 

See Code Samples

 

 

Membership Options

CPHs are regulated by your membership level. Below is the breakdown of memberships and CPHs:

 

  • No membership:              100 CPH
  • Basic membership:           200 CPH
  • Premium membership:     1,000 CPH
  • Exclusive membership:     2,000 CPH

 

To get started with a membership, apply for a consumer key.

 

 

<< Back to Swarm API Documentation

 

 

 

 

 

Comments (0)

You don't have permission to comment on this page.