Endpoints Departments

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

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.ApiClient;
import com.moncreneau.model.Department;
import java.util.List;

ApiClient client = new ApiClient("your_api_key");
List<Department> departments = client.departments().list();

for (Department dept : departments) {
    System.out.println(dept.getName() + " - " + dept.getAddress());
}

Node.js

const { MoncreneauClient } = require('moncreneau');

const client = new MoncreneauClient('your_api_key');

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

PHP

<?php
use Moncreneau\Client;

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

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

Python

from moncreneau import MoncreneauClient

client = MoncreneauClient('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.ApiClient;
import com.moncreneau.model.Department;

ApiClient client = new ApiClient("your_api_key");
Department dept = client.departments().get(5L);

System.out.println("Nom: " + dept.getName());
System.out.println("Adresse: " + dept.getAddress());
System.out.println("Intervalle: " + dept.getSlotInterval() + " minutes");

Node.js

const { MoncreneauClient } = require('moncreneau');

const client = new MoncreneauClient('your_api_key');
const dept = await client.departments.get(5);

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

PHP

<?php
use Moncreneau\Client;

$client = new Client('your_api_key');
$dept = $client->departments->get(5);

echo "Nom: {$dept->name}" . PHP_EOL;
echo "Adresse: {$dept->address}" . PHP_EOL;
echo "Intervalle: {$dept->slotInterval} minutes" . PHP_EOL;

Python

from moncreneau import MoncreneauClient

client = MoncreneauClient('your_api_key')
dept = client.departments.get(5)

print(f"Nom: {dept.name}")
print(f"Adresse: {dept.address}")
print(f"Intervalle: {dept.slot_interval} 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

{
  "code": "DEPARTMENT_NOT_FOUND",
  "message": "Department not found with id: 5",
  "timestamp": "2026-01-21T10:00:00"
}

---

GET /departments/{id}/availability

Vérifie la disponibilité d'un créneau horaire pour un département.

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.ApiClient;
import com.moncreneau.model.SlotAvailability;
import java.time.LocalDateTime;

ApiClient client = new ApiClient("your_api_key");
LocalDateTime dateTime = LocalDateTime.parse("2026-02-15T10:00:00");

SlotAvailability availability = client.departments()
    .checkAvailability(5L, dateTime);

if (availability.isAvailable()) {
    System.out.println("Créneau disponible! Places restantes: " + 
                       availability.getRemainingSlots());
} else {
    System.out.println("Créneau indisponible: " + 
                       availability.getUnavailabilityReason());
}

Node.js

const { MoncreneauClient } = require('moncreneau');

const client = new MoncreneauClient('your_api_key');
const dateTime = '2026-02-15T10:00:00';

const availability = await client.departments.checkAvailability(5, dateTime);

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

PHP

<?php
use Moncreneau\Client;

$client = new Client('your_api_key');
$dateTime = '2026-02-15T10:00:00';

$availability = $client->departments->checkAvailability(5, $dateTime);

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 MoncreneauClient

client = MoncreneauClient('your_api_key')
date_time = '2026-02-15T10:00:00'

availability = client.departments.check_availability(5, date_time)

if availability.available:
    print(f"Créneau disponible! Places restantes: {availability.remaining_slots}")
else:
    print(f"Créneau indisponible: {availability.unavailability_reason}")

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)"
}