FMJD Public Player API

Version: 1.0

The FMJD Public Player API provides open access to core information about FMJD-registered draughts players. This API is free to use, requires no authentication, and is designed for public applications, tools, and federations.

Base URL

https://fmjd.org/webservices/api/public/

1. Overview

The API returns:

First and last name
Gender
Country (ISO-2)
Rating
Women’s rating (if applicable)
Title and women’s title
Player profile URL
Player image URL

2. Endpoint: Get Player by ID

GET /players/{id}

Example Request

GET https://fmjd.org/webservices/api/public/players/10007

Path Parameters

Name	Type	Required	Description
id	Integer	Yes	FMJD ID

Example Response

{
  "id": "10018",
  "first_name": "Alexander",
  "last_name": "Presman",
  "gender": "M",
  "country": "nl",
  "rating": "2364",
  "wrating": "0",
  "title": "gmi",
  "wtitle": "",
  "personal_url": "https://www.fmjd.org/?p=pcard&id=10018",
  "image_url": "https://www.fmjd.org/downloads/DA/images/10018.PNG"
}

3. Error Responses

Player Not Found

{"error": "Player not found"}

Internal Server Error

{"error": "Internal error"}

4. Usage Examples

cURL

curl https://fmjd.org/webservices/api/public/players/10007

JavaScript (Fetch API)

fetch("https://fmjd.org/webservices/api/public/players/10007")
  .then(r => r.json())
  .then(player => console.log(player));

PHP

$player = json_decode(file_get_contents(
    "https://fmjd.org/webservices/api/public/players/10007"
), true);

echo $player['first_name'] . " " . $player['last_name'];

Python

import requests
r = requests.get("https://fmjd.org/webservices/api/public/players/10007")
print(r.json())

5. Rate Limits

Public API — no key required
Suggested max: 60 requests/minute per IP

6. URLs Returned by API

Type	Format
Player Profile	`https://fmjd.org/players/{id}`
Player Image	`https://fmjd.org/photos/players/{id}.jpg`

7. Contact

FMJD IT Department
Email: webmaster@fmjd.org
Website: https://fmjd.org