Project

cocRb

0.0
No commit activity in last 3 years
No release in over 3 years
A Gem for interacting with the Clash of Clans API easily!
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 10.0
~> 3.0
~> 6.3.1

Runtime

~> 1.4.1
~> 2.5.1
~> 0.1.0
 Project Readme

coc Rb

CocRb

Welcome everyone to your Ruby Gem CocRb. By using this gem you can easily interact with the Game API of Clash of Clans without using any external gems to call this service.

Installation

Add this line to your application's Gemfile:

gem 'cocRb'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install cocRb

Links

Optional Paramters

  • status: This is default set to false on every method except verify_PlayerByToken method. The method Parameter takes any String as an arguement. Returns => Status Code for a method

  • _limit: This is also set to false. You can limit any request where limit parameter is available for a method. Paramter Data Type => Integer

Method Options

Filter Options

  • warFrequency
  • locationId
  • minMembers
  • maxMembers
  • minClanPoints
  • minClanLevel

Team Input Options

  • clan
  • opponent

Status Codes

  • 200: Successful Response.
  • 400: Client provided incorrect parameters for the request.
  • 403: Access denied, either because of missing/incorrect credentials or used API token does not grant access to the requested resource.
  • 404: Resource was not found.
  • 429: Request was throttled, because amount of requests was above the threshold defined for the used API token.
  • 500: Unknown error happened when handling the request.
  • 503: Service is temporarily unavailable because of maintenance.
  • 504: Request Timeout.

Usage

CocRb Gem is categorized with Classes and Methods as below down you can see but before accessing any of those we have to set Configuration in order to setup the Authorization for accessing the Clash of Clans API so to do that we have set Configure block and inside that block we have configured our TOKEN and the URL.

token = <Your_Token>
requestUrl = <Your_Url>

CocRb.configure do |config|
     config.token = token
     config.url = requestUrl
end

After done setting up the Authorization we now need to call the API as you can see down below we called the API using call_API method now just before that line we have set the class ClashApi by name_spacing with CocRb Module.

Note: All the data that we will get from the API response was in JSON but since you are using this gem all of the responses has been parsed to Ruby Hashes so that its get easy for you to access the data.

set_Class = CocRb::ClashApi

response = set_Class.call_API

puts response

# data from the API in Ruby Hashes...

The API can also be called without using the URL in the Configuration block the way you can do is shown down below. As you can we have almost followed the same procedure like we did before just changed few things those are we have removed the config.url line, We now have called a new class and a method. This method now takes two parameters one is your Player Tag and another thing is your Player API Token which you will find In-Game Settings.

CocRb.configure do |config|
     config.token = token
end

set_var = CocRb::Player   

response = set_var.verify_PlayerByToken(tag: "#PG8RLGQ2", playertoken: "7jeagw4c")

# Response => {"tag"=>"#PG8RLGQ2", "token"=>"7jeagw4c", "status"=>"ok"}

Support

  • If you need any help understanding the Library, you can join our Discord Server
  • OR You can create a new Issue on this Repo.

License

The gem is available as open source under the terms of the MIT License.