Éducation/API v2

Un établissement · Établissements BTS

GET/api/v2/education/etablissements-publics-bts/{id}

À savoir. Les filtres géographiques utilisent les libellés du fichier source, pas les codes administratifs. Universités : annuaire 2024-2025, effectifs 2023-2024.

Comprendre le contexte

Le collégial est le secondaire inférieur ; le qualifiant est le secondaire supérieur. BTS signifie Brevet de technicien supérieur, une formation technique postsecondaire. CPGE signifie Classes préparatoires aux grandes écoles : préparation aux concours d’entrée d’écoles supérieures. Une université regroupe plusieurs établissements (facultés, écoles, instituts).

Comprendre la réponse

data: Les résultats demandés, sous forme d’objet ou de liste.

meta: Sources, licence et dates du jeu de données. null signifie une valeur inconnue ou indisponible.

API v2 est le chemin de référence. Les anciens chemins /api/v1 restent des alias de compatibilité du comportement actuellement publié, pagination comprise ; aucune date de suppression n’est fixée.

Champs renvoyés 11

[] désigne chaque élément d’une liste. null signifie inconnu ou indisponible, jamais zéro. La langue du guide ne traduit pas les valeurs des sources.

dataobject

Résultat demandé : objet unique ou liste.

data.idstring

Identifiant de cet élément dans le jeu de données ; pas nécessairement un code officiel.

data.name_frstring

Nom de l’établissement en français, tel que publié.

data.name_arstring

Nom de l’établissement en arabe, tel que publié.

data.address_frstring | null

Adresse en français fournie par la source.

data.address_arstring | null

Adresse en arabe fournie par la source.

data.communestring

Libellé source de la commune ou de l’arrondissement ; pas un identifiant MoroccoAPI.

data.provincestring

Libellé source de la province ou préfecture, niveau situé sous la région.

data.regionstring

Nom source de la région, premier niveau administratif.

data.categorystring

Catégorie de l’établissement ou du préfixe ; utilisez les valeurs publiées.

Valeurs acceptées: "private-school" "private-cpge" "public-primary" "public-collegial" "public-qualifying" "public-bts" "public-cpge"

data.ownershipstring

Statut public ou privé de l’établissement, tel que renseigné.

Valeurs acceptées: "public" "private"

Structure des données

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "name_fr",
        "name_ar",
        "address_fr",
        "address_ar",
        "commune",
        "province",
        "region",
        "category",
        "ownership"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name_fr": {
          "type": "string"
        },
        "name_ar": {
          "type": "string"
        },
        "address_fr": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "string",
              "nullable": true,
              "enum": [
                null
              ]
            }
          ]
        },
        "address_ar": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "string",
              "nullable": true,
              "enum": [
                null
              ]
            }
          ]
        },
        "commune": {
          "type": "string",
          "description": "Commune or arrondissement label as published in the source."
        },
        "province": {
          "type": "string",
          "description": "Province or prefecture label as published in the source."
        },
        "region": {
          "type": "string"
        },
        "category": {
          "type": "string",
          "enum": [
            "private-school",
            "private-cpge",
            "public-primary",
            "public-collegial",
            "public-qualifying",
            "public-bts",
            "public-cpge"
          ]
        },
        "ownership": {
          "type": "string",
          "enum": [
            "public",
            "private"
          ]
        }
      }
    },
    "meta": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dataset",
        "total",
        "license",
        "retrieved_at",
        "transformation_version",
        "sources"
      ],
      "properties": {
        "dataset": {
          "enum": [
            "etablissements-publics-bts"
          ]
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "license": {
          "enum": [
            "ODbL-1.0"
          ]
        },
        "retrieved_at": {
          "enum": [
            "2026-10-13"
          ]
        },
        "transformation_version": {
          "enum": [
            "1.0.0"
          ]
        },
        "sources": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "dataset",
              "producer",
              "source_url",
              "resource_url",
              "license",
              "source_updated_at"
            ],
            "properties": {
              "dataset": {
                "type": "string"
              },
              "producer": {
                "type": "string"
              },
              "source_url": {
                "type": "string",
                "format": "uri"
              },
              "resource_url": {
                "type": "string",
                "format": "uri"
              },
              "license": {
                "enum": [
                  "ODbL-1.0"
                ]
              },
              "source_updated_at": {
                "type": "string",
                "format": "date"
              }
            }
          }
        }
      }
    }
  }
}

Sources et pagination 13

metaobject

Contexte du résultat : sources, dates, licence et pagination si applicable.

meta.datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

Valeurs acceptées: "etablissements-publics-bts"

meta.totalinteger

Nombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.

meta.licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "ODbL-1.0"

meta.retrieved_atstring

Date de récupération du fichier source par le projet ; pas la date des observations.

Valeurs acceptées: "2026-10-13"

meta.transformation_versionstring

Version des règles de conversion du jeu de données ; distincte de l’API.

Valeurs acceptées: "1.0.0"

meta.sourcesobject[]

Sources utilisées pour ce résultat, avec leurs producteurs et licences.

meta.sources[].datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

meta.sources[].producerstring

Organisme qui publie la donnée originale.

meta.sources[].source_urlstring

Page de présentation ou de publication de la source.

meta.sources[].resource_urlstring

Lien vers le fichier ou la ressource utilisée.

meta.sources[].licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "ODbL-1.0"

meta.sources[].source_updated_atstring

Dernière mise à jour annoncée par la source ; pas la date de récupération.

Erreurs

400: Paramètre invalide ou manquant.
404: Ressource introuvable.

Les erreurs renvoient error.code, error.message et error.request_id.

errorobject: Détails d’une requête échouée ; remplace data et meta.
error.codestring: Code stable de l’erreur, par exemple RESOURCE_NOT_FOUND ; à utiliser dans votre logique.
error.messagestring: Explication lisible de l’erreur ; utilisez code pour la logique de votre application.
error.request_idstring: Identifiant du traitement de cette requête, utile pour retrouver un problème.

Un établissement · Établissements BTS

Paramètres

Votre requête