Endpoints Departments

Consulter les départements disponibles et vérifier les disponibilités.

SDK PHP et Java

Les exemples PHP et Java ci-dessous utilisent la syntaxe des SDK officiels — pas encore publiés sur Packagist/Maven Central (voir SDK PHP et SDK Java). Node.js et Python sont publiés et utilisables dès aujourd'hui.

GET /departments

Liste tous les départements de votre organisation.

Request

curl https://mc-prd.duckdns.org/api/v1/departments \
-H "X-API-Key: YOUR_API_KEY"

Java

import com.moncreneau.Moncreneau;
import java.util.List;
import java.util.Map;

Moncreneau client = new Moncreneau("your_api_key");
List<Map<String, Object>> departments = client.departments.list();

for (Map<String, Object> dept : departments) {
    System.out.println(dept.get("name") + " - " + dept.get("address"));
}

Node.js

import Moncreneau from '@moncreneau/api';

const client = new Moncreneau('your_api_key');

const departments = await client.departments.list();
departments.forEach(dept => {
  console.log(`${dept.name} - ${dept.address}`);
});

PHP

<?php
use Moncreneau\Moncreneau;

$client = new Moncreneau('your_api_key');
$departments = $client->departments->list();

foreach ($departments as $dept) {
    echo $dept['name'] . ' - ' . $dept['address'] . PHP_EOL;
}

Python

from moncreneau import Moncreneau

client = Moncreneau('your_api_key')
departments = client.departments.list()

for dept in departments:
    print(f"{dept['name']} - {dept['address']}")

Response 200

[
  {
    "id": 5,
    "name": "Consultation générale",
    "address": "123 Rue de la Santé, Conakry",
    "phoneNumber": "+224 123 456 789",
    "slotInterval": 30,
    "workingHours": "Lundi-Vendredi: 08:00-17:00"
  },
  {
    "id": 8,
    "name": "Urgences",
    "address": "456 Avenue de la République",
    "phoneNumber": "+224 987 654 321",
    "slotInterval": 15,
    "workingHours": "Lundi-Dimanche: 00:00-23:59"
  }
]

---

GET /departments/{id}

Récupère les détails d'un département spécifique.

Request

curl https://mc-prd.duckdns.org/api/v1/departments/5 \
-H "X-API-Key: YOUR_API_KEY"

Java

import com.moncreneau.Moncreneau;
import java.util.Map;

Moncreneau client = new Moncreneau("your_api_key");
Map<String, Object> dept = client.departments.retrieve("5");

System.out.println("Nom: " + dept.get("name"));
System.out.println("Adresse: " + dept.get("address"));
System.out.println("Intervalle: " + dept.get("slotInterval") + " minutes");

Node.js

import Moncreneau from '@moncreneau/api';

const client = new Moncreneau('your_api_key');
const dept = await client.departments.retrieve('5');

console.log(`Nom: ${dept.name}`);
console.log(`Adresse: ${dept.address}`);
console.log(`Intervalle: ${dept.slotInterval} minutes`);

PHP

<?php
use Moncreneau\Moncreneau;

$client = new Moncreneau('your_api_key');
$dept = $client->departments->retrieve('5');

echo "Nom: {$dept['name']}" . PHP_EOL;
echo "Adresse: {$dept['address']}" . PHP_EOL;
echo "Intervalle: {$dept['slotInterval']} minutes" . PHP_EOL;

Python

from moncreneau import Moncreneau

client = Moncreneau('your_api_key')
dept = client.departments.retrieve('5')

print(f"Nom: {dept['name']}")
print(f"Adresse: {dept['address']}")
print(f"Intervalle: {dept['slotInterval']} minutes")

Response 200

{
  "id": 5,
  "name": "Consultation générale",
  "address": "123 Rue de la Santé, Conakry",
  "phoneNumber": "+224 123 456 789",
  "slotInterval": 30,
  "workingHours": "Lundi-Vendredi: 08:00-17:00"
}

Response 404

{
  "error": {
    "code": "DEPARTMENT_NOT_FOUND",
    "message": "Department not found with id: 5"
  }
}

---

GET /departments/{id}/availability

Vérifie la disponibilité d'un créneau horaire précis pour un département (un dateTime unique — pas une plage de dates).

Request

curl "https://mc-prd.duckdns.org/api/v1/departments/5/availability?dateTime=2026-02-15T10:00:00" \
-H "X-API-Key: YOUR_API_KEY"

Java

import com.moncreneau.Moncreneau;
import java.util.Map;

Moncreneau client = new Moncreneau("your_api_key");

Map<String, Object> availability = client.departments.getAvailability("5", "2026-02-15T10:00:00");

if (Boolean.TRUE.equals(availability.get("available"))) {
    System.out.println("Créneau disponible! Places restantes: " + availability.get("remainingSlots"));
} else {
    System.out.println("Créneau indisponible: " + availability.get("unavailabilityReason"));
}

Node.js

import Moncreneau from '@moncreneau/api';

const client = new Moncreneau('your_api_key');

const availability = await client.departments.getAvailability('5', '2026-02-15T10:00:00');

if (availability.available) {
  console.log(`Créneau disponible! Places restantes: ${availability.remainingSlots}`);
} else {
  console.log(`Créneau indisponible: ${availability.unavailabilityReason}`);
}

PHP

<?php
use Moncreneau\Moncreneau;

$client = new Moncreneau('your_api_key');

$availability = $client->departments->getAvailability('5', '2026-02-15T10:00:00');

if ($availability['available']) {
    echo "Créneau disponible! Places restantes: {$availability['remainingSlots']}" . PHP_EOL;
} else {
    echo "Créneau indisponible: {$availability['unavailabilityReason']}" . PHP_EOL;
}

Python

from moncreneau import Moncreneau

client = Moncreneau('your_api_key')

availability = client.departments.get_availability('5', '2026-02-15T10:00:00')

if availability['available']:
    print(f"Créneau disponible! Places restantes: {availability['remainingSlots']}")
else:
    print(f"Créneau indisponible: {availability['unavailabilityReason']}")

Response 200 - Disponible

{
  "slotTime": "2026-02-15T10:00:00",
  "available": true,
  "remainingSlots": 3,
  "unavailabilityReason": null
}

Response 200 - Indisponible

{
  "slotTime": "2026-02-15T10:00:00",
  "available": false,
  "remainingSlots": 0,
  "unavailabilityReason": "Slot full (5/5 appointments)"
}

Response 400 - Date invalide

{
  "error": {
    "code": "INVALID_DATE_FORMAT",
    "message": "dateTime must be an ISO-8601 date-time, e.g. 2026-01-05T16:30:00"
  }
}