Skip to content

Détails catalogue & géo (JSON:API « 360° »)

Ces endpoints exposent le détail d’une ressource unique des domaines adossés à Meilisearch (lecture seule, aucune table MySQL côté Hydrogen). Tous suivent la convention JSON:API 1.1 : strict superset du GET /api/<domaine>/{id} public — même type/id/attributes (via le *HitFormatter partagé) + les mêmes enrichissements (descriptions Markdown, blocs hiérarchiques…) que le public, plus tous les champs bruts de l’index Meili rétro-remplis dans data.attributes via le trait MergesRawHit (une clé déjà émise par le formatter n’est jamais écrasée).

Robustesse commune : id malformé → 404 (erreur JSON:API) ; index Meili injoignable → 503 ; aucun hit → 404.

Endpointtypeid (path & data.id)Enrichissements (comme le public)
GET /admin/establishments/{id}establishments32 hex minusculesimages + description (assets statiques)
GET /admin/offers/{id}offers32 hex minuscules— (champs bruts index uniquement)
GET /admin/countries/{code}countriescode ISO minuscule (Meili stocke en MAJ)description (Markdown)
GET /admin/regions/{code}regionsISO 3166-2 minusculedescription (Markdown) + bloc country
GET /admin/subregions/{code}subregionsISO 3166-2 minusculedescription (Markdown) + blocs country + region
GET /admin/cities/{id}citiesUUID dashéblocs country + region + subregion

Exemple

Terminal window
curl -s -H "Authorization: Bearer $ADMIN_API_TOKEN" \
-H "Accept: application/vnd.api+json" \
"http://hydrogen.dev.com/admin/countries/fr"
{
"jsonapi": { "version": "1.1" },
"data": {
"type": "countries",
"id": "fr",
"attributes": {
"name": "France", "slug": "france", "continent": "Europe",
"description": "# France\n",
"…": "+ tous les champs bruts de l'index Meili countries (rétro-remplis)"
}
}
}