Development Tools

Tools and resources for developers working with the JCA website and brand assets.

Colour Guide

Explore our curated palette of JCA brand colours. Each colour includes WCAG compliance information and usage guidelines.

View Colour Guide →

Accessibility Audit

Complete WCAG 2.1 compliance analysis of all JCA colour combinations. See which colours work together and their contrast ratios.

View Full Audit →

Japan Region Map

Interactive map prototype. Hover to highlight a region, click to select. This component will be integrated into the Play Cricket page for club filtering.

Filter by Region

CricClubs API

Reference documentation for the CricClubs API used to fetch match data, scorecards, stats, and tournament information.

Authentication

All requests require two headers:

Header	Value
`x-consumer-key`	`••••••••`
`x-api-key`	`••••••••`

Base URL: https://core-prod-origin.cricclubs.com

Club ID: 21278 (static for all requests)

Data Hierarchy

Club (21278 - Japan Cricket Association)
 └── Series / Tournament (seriesId / leagueId)
      ├── Teams (teamId)
      │    └── Players (playerID)
      ├── Matches (matchId)
      │    ├── Scorecard
      │    └── Ball-by-Ball
      ├── Points Table
      └── Player Stats (Batting / Bowling)

Key: seriesId in API params = leagueId in responses = league in frontend URLs

Response Envelope

{
  "data": { ... },
  "errorMessage": null,
  "errorCode": null,
  "responseState": true
}

Endpoints (11)

Implementation Notes

All endpoints are GET requests (read-only)
Image paths are relative — prepend https://cricclubs.com
Date formats vary: Unix timestamp, MM/DD/YYYY, ISO 8601
Economy rate is often null — calculate as (runs / balls) * 6
Average/strike rate may be 0 — calculate manually
No fielding stats endpoint; catches are in bowling stats
Omitting seriesId or teamId returns data across all