openapi: 3.0.3 info: title: API Mir@bel description: | Web-service REST pour interroger Mir@bel. Données sous [Licence Ouverte](https://www.etalab.gouv.fr/licence-ouverte-open-licence), compatible ODC-BY et CC-BY 2.0. Réutilisation possible des données à condition d'en mentionner l'origine. Les versions futures de cette API resteront compatibles avec les versions 1.* précédentes. Donc une requête pour la version actuelle de l'API restera valable dans le futur, avec une réponse éventuellement enrichie de champs supplémentaires. - **v1.4.0** (sept 2023) Critère de recherche par grappe pour /titres. - **v1.3.0** (juin 2023) Ajout de Titre.labellisation, Titre.sigle et Acces.ressourcesigle. Ajout de /themes, /theme/revue/{id}, /theme/titre/{id}. Critère de recherche par thème pour /titres. Correction d'un bug sur /mes/acces/changes - **v1.2.1** (fév 2023) Les chemins /editeurs/{id} /revues/{id} et /titres/{id} gèrent les redirections - **v1.2.0** (juin 2022) Ajout d'informations sur les éditeurs, par une extension des données du modèle Titre et la création de points d'entrée /editeurs. Le champ Titre.editeurs ne liste plus que les éditeurs *actuels*. - **v1.1.6** (fév 2022) La documentation nommait "datebarriereinfo" un champ disponible sous le nom "dateinfo". - **v1.1.5** (nov 2020) Corrige un bug sur /acces concernant les abonnements par collections. - **v1.1.4** (sept 2020) Les critères "lacunaire" et "selection" sont booléens. Le texte recherché doit contenir 3 caractères au minimum. - **v1.1.3** (juil 2020) Ajout de l'identifiant "bnfark". Autorise /titres et /mes/titres sans filtre. Les ISSN de titre étaient absents des titres de /revues. Corrections mineures. - **v1.1.2** (nov 2019) Ajout de Acces.url_proxy quand pertinent. Acces.url pointe sur sa ressource à défaut d'URL spécifique. Ajout de Acces.lacunaire et Acces.selection. - **v1.1.0** (nov 2019) Remplacement du critère `lien=possession` par `possession=1`. Ajout du critère `abonnement=1`. Ajout de nombreux champs dans les données renvoyées. - **v1.0.0** (mai 2019) Première version publique. version: 1.3.0 contact: name: Mir@bel url: https://reseau-mirabel.info/site/contact license: name: Licence ouverte url: https://www.etalab.gouv.fr/licence-ouverte-open-licence paths: /acces/revue: get: operationId: /acces/revue summary: Liste des accès sur une revue description: | Liste tous les accès sur une revue (qui peut regrouper plusieurs titres si l'historique de la revue est complexe). La revue est identifiée par son ID dans Mir@bel, ou un ISSN, un numéro OCLC de Worldcat, etc. Au moins un critère est nécessaire. Les critères sont combinés par un ET logique (les revues valident tous les critères). Par exemple, [/acces/revue?issn=1169-1018](/api/acces/revue?issn=1169-1018) montrera les accès en ligne pour la revue "Population (english edition)" dont l'ancien titre a cet ISSN. parameters: - name: issn in: query description: Numéro ISSN (ou ISSN-e) de la forme XXXX-XXXX examples: issn: summary: Accès pour une revue désignée par son ISSN value: "0001-7728" schema: type: string - name: partenaire in: query description: | Clé privée du partenaire. Si ce paramètre est fourni, les accès en ligne pourront avoir une diffusion "abonné" au lieu de "restreint". schema: type: string - name: revueid in: query description: Identifiant numérique de la revue dans Mir@bel. schema: type: integer - name: sudoc in: query description: Identifiant PPN de SUDOC. examples: ppn: summary: Accès pour une revue désignée par son PPN value: "039219208" schema: type: string - name: worldcat in: query description: Identifiant numérique de Worldcat. schema: type: integer responses: "200": description: liste d'accès content: application/json: schema: type: array items: $ref: "#/components/schemas/Acces" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" /acces/titres: get: operationId: /acces/titres summary: Liste des accès sur une sélection de titres description: | Liste tous les accès sur des titres de revue (qui peuvent différer de la revue s'il y a un historique de titres). Chaque titre est identifié par son ID dans Mir@bel, ou un ISSN, un numéro OCLC de Worldcat, etc. Au moins un critère est nécessaire. Les critères sont combinés par un ET logique (les titres valident tous les critères). Par exemple, [/acces/titres?issn=1169-1018](/api/acces/titres?issn=1169-1018) montrera les accès en ligne pour le titre "Population (english selection)" qui a cet ISSN. Les critères de recherche sont les mêmes que pour /titres. parameters: - name: actif in: query description: | Restreindre aux titres actifs. Autrement dit, exclure les anciens titres des revues, ceux qui ont des successeurs. schema: type: boolean - name: id in: query description: | Identifiant numérique du titre dans Mir@bel. Il est aussi possible de donner une liste de nombres séparés par des virgules, par exemple [id=14,72,1044](/api/acces/titres?id=14,72,1044) pour sélectionner les accès de ces trois titres. schema: type: integer - name: issn in: query description: | Numéro ISSN (ou ISSN-e ou ISSN-l) de la forme XXXX-XXXX. Une liste d'ISSN est possible, par exemple [issn=1660-7880,1776-8098](/api/acces/titres?issn=1660-7880,1776-8098). examples: issn: summary: Accès pour un titre désigné par son ISSN value: "0001-7728" issns: summary: Accès pour les titres ayant un de ces ISSN value: "0001-7728,2552-0016" schema: type: string - name: partenaire in: query description: | Clé privée du partenaire. Si ce paramètre est fourni, les accès en ligne pourront avoir une diffusion "abonné" au lieu de "restreint". Il doit aussi être donné pour utiliser les critères "possession" et "abonnement". schema: type: string - name: abonnement in: query description: | Restreint la liste aux titres auxquels le partenaire est abonné, via une collection ou une ressource. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: possession in: query description: | Si possession=1, seuls les titres possédés par le partenaire seront concernés. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: revueid in: query description: | Identifiant numérique de la revue dans Mir@bel, ou liste avec des virgules comme séparateurs. Si ce critère est présent, les titres seront ordonnés du plus récent au plus ancien, pour rendre l'historique de titre de la revue plus lisible. schema: type: integer - name: sudoc in: query description: Identifiant PPN de SUDOC. schema: type: string - name: titre in: query description: Titre. Le préfixe sera ignoré ("Monde" ou "Le Monde" donne le même résultat). Une recherche en début ("Monde%") ou milieu de titre ("%monde%") est possible. Une recherche exacte portera aussi sur le sigle des titres (par exemple, "titre=AJDA"). schema: type: string - name: worldcat in: query description: Identifiant numérique OCN de Worldcat, ou liste d'identifiants joints par des virgules. schema: type: integer responses: "200": description: liste d'accès content: application/json: schema: type: array items: $ref: "#/components/schemas/Acces" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" "/editeurs/{id}": get: operationId: /editeurs/ID summary: Détail d'un éditeur identifié par son ID Mir@bel description: | Les infos que Mir@bel fournit sur un éditeur identifié par son ID dans Mir@bel ou par son IdRef. Par exemple, [/editeurs/64](/api/editeurs/64) pour décrire l'éditeur qui a l'identifiant 64 dans Mir@bel. parameters: - name: id in: path description: Identifiant numérique de l'éditeur (ID interne à Mir@bel). schema: type: string required: true responses: "200": description: Détail d'un éditeur content: application/json: schema: type: object properties: editeur: $ref: "#/components/schemas/Editeur" relations_titres: type: array items: $ref: "#/components/schemas/EditeurTitre" "301": description: Redirection content: application/json: schema: $ref: "#/components/schemas/Redirection" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" "/editeurs/idref/{idref}": get: operationId: /editeurs/idref summary: Détail d'un éditeur cherché par son IdRef description: | Par exemple, [/editeurs/idref/029524989](/api/editeurs/idref/029524989). parameters: - name: idref in: path description: Identifiant IdRef de l'éditeur, de type PPN (8 chiffres suivis d'un chiffre ou de "X"). schema: type: string required: true responses: "200": description: Détail d'un éditeur content: application/json: schema: type: object properties: editeur: $ref: "#/components/schemas/Editeur" relations_titres: type: array items: $ref: "#/components/schemas/EditeurTitre" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" "/revues/{id}": get: operationId: /revues/ID summary: Détail d'une revue description: | Pour éviter une requête supplémentaire, l'historique des titres de la revue est aussi fourni, en commençant par le plus récent. Par exemple, [/revues/3221](/api/revues/3221) montrera les dates de dernière modification et de vérification de la revue, ainsi que son historique de titres. Le premier titre est le titre actif. parameters: - name: id in: path description: Identifiant numérique de la revue. schema: type: integer required: true responses: "200": description: Détail d'une revue et de ses titres content: application/json: schema: type: object properties: revue: $ref: "#/components/schemas/Revue" "301": description: Redirection content: application/json: schema: $ref: "#/components/schemas/Redirection" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" /themes: get: operationId: /themes summary: Liste ordonnée de la thématique (taxonomie) utilisée par Mir@bel. description: | Chaque élément de la liste renvoyée est un thème. La liste est à plat alors que la structure est hiérarchique. Les champs "parentid" permettent de reconstruire l'arborescence. La liste est triée selon l'ordre d'affichage, ce qui dépend d'abord de la position dans l'arbre, puis de l'ordre alphabétique des thèmes. responses: "200": description: liste de thèmes content: application/json: schema: type: array items: $ref: "#/components/schemas/Theme" "/themes/revue/{id}": get: operationId: /themes/revue summary: Liste ordonnée des thèmes attribués à cette revue. description: | Chaque élément de la liste renvoyée est un thème. Par exemple, [/themes/revue/88](/api/themes/revue/88) produit la liste des thèmes de la revue d'identifiant 88. Attention, dans Mir@bel, les thèmes sont associés à la revue, c'est-à-dire l'ensemble de ses titres. parameters: - name: id in: path description: Identifiant numérique de la revue. schema: type: integer required: true responses: "200": description: liste des thèmes de la revue content: application/json: schema: type: array items: $ref: "#/components/schemas/Theme" "/themes/titre/{id}": get: operationId: /themes/titre summary: Liste ordonnée des thèmes attribués à un titre. description: | La réponse est identique celle de la revue du titre désigné. Cette action permet simplement d'éviter une requête pour remonter de l'identifiant d'un titre à celui de sa revue. parameters: - name: id in: path description: Identifiant numérique du titre. schema: type: integer required: true responses: "200": description: liste des thèmes de la revue de ce titre content: application/json: schema: type: array items: $ref: "#/components/schemas/Theme" "/titres/{id}": get: operationId: /titres/ID summary: Détail d'un titre description: | Les infos que Mir@bel fournit sur un titre par son ID dans Mir@bel. Par exemple, [/titres/14](/api/titres/14) pour trouver le titre qui a l'identifiant 14 dans Mir@bel. parameters: - name: id in: path description: Identifiant numérique du titre. schema: type: integer required: true responses: "200": description: Détail d'un titre content: application/json: schema: $ref: "#/components/schemas/Titre" "301": description: Redirection content: application/json: schema: $ref: "#/components/schemas/Redirection" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" /titres: get: operationId: /titres summary: Liste de titres recherchés par différents critères description: | Liste les titres correspondant aux critères de recherche. Donner au moins un paramètre dans la requête pour sélectionner le titre. Par exemple, [/titres?issn=1660-7880](/api/titres?issn=1660-7880) pour trouver le titre qui a l'ISSN 1660-7880, ou [/titres?titre=%monde%](/api/titres?titre=%monde%) pour lister les titres contenant "Monde", ou [/titres](/api/titres) pour l'ensemble des titres. Les titres sont triés alphabétiquement, hors préfixes. parameters: - name: actif in: query description: | Restreindre aux titres actifs. Autrement dit, exclure les anciens titres des revues, ceux qui ont des successeurs. schema: type: boolean - name: grappeid in: query description: | Identifiant numérique d'une grappe. Certaines grappes sont soumises à autorisation et ne seront accessibles que si le partenaire est authentifié. schema: type: integer - name: id in: query description: | Identifiant numérique du titre dans Mir@bel. Il est aussi possible de donner une liste de nombres séparés par des virgules, par exemple [id=14,72,1044](/api/titres?id=14,72,1044) pour sélectionner ces trois titres. schema: type: integer - name: issn in: query description: | Numéro ISSN (ou ISSN-e ou ISSN-l) de la forme XXXX-XXXX. Une liste d'ISSN est possible, par exemple [issn=1660-7880,1776-8098](/api/titres?issn=1660-7880,1776-8098). schema: type: string - name: offset in: query description: Les réponses sont limitées à 1000 titres. Si cette limite est atteinte, ce paramètre permet de demander la suite avec `offset=1000` etc. schema: type: integer - name: revueid in: query description: | Identifiant numérique de la revue dans Mir@bel, ou liste avec des virgules comme séparateurs. Si ce critère est présent, les titres seront ordonnés du plus récent au plus ancien, pour rendre l'historique de titre de la revue plus lisible. schema: type: integer - name: sudoc in: query description: Identifiant PPN de SUDOC. schema: type: string - name: themeid in: query description: | Identifiant numérique d'un thème. La thématique complète de Mir@bel, avec ces identifiants, est accessible par `/themes`. schema: type: integer - name: titre in: query description: | Titre. Le préfixe sera ignoré ("Monde" ou "Le Monde" donne le même résultat). Une recherche en début ("Monde%") ou milieu de titre ("%monde%") est possible. Une recherche exacte portera aussi sur le sigle des titres (par exemple, "titre=AJDA"). schema: type: string - name: worldcat in: query description: Identifiant numérique OCN de Worldcat, ou liste d'identifiants joints par des virgules. schema: type: integer responses: "200": description: Liste de titres content: application/json: schema: type: array items: $ref: "#/components/schemas/Titre" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" /mes/acces: get: operationId: /mes/acces summary: Pour un partenaire de Mir@bel, liste des accès sur ses revues description: | Liste de tous les accès sur les revues du partenaire, sélectionnées par possession ou abonnement. Au moins l'un des deux critères ("abonnement" ou "possession") doit être présent. *L'accès est restreint aux partenaires de Mir@bel.* Exemple listant les accès en ligne sur les possessions et les abonnements `/mes/acces?abonnement=1&possession=1&partenaire={HASH}` (remplacer {HASH} par la clé privée du partnaire pour cette API). parameters: - name: partenaire in: query required: true description: Clé privée du partenaire schema: type: string - name: abonnement in: query description: | Restreint la liste aux titres auxquels le partenaire est abonné, via une collection ou une ressource. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: possession in: query description: | Si possession=1 et abonnement=0, seuls les titres possédés par le partenaire seront concernés. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean responses: "200": description: liste d'accès content: application/json: schema: type: array items: $ref: "#/components/schemas/Acces" /mes/acces/changes: get: operationId: /mes/acces/changes summary: Pour un partenaire de Mir@bel, liste des modifications d'accès sur ses revues description: | Liste les ajouts, modifications et suppressions concernant les accès des revues du partenaire, sélectionnées par possession ou abonnement (cf /mes/acces). *L'accès est restreint aux partenaires de Mir@bel.* parameters: - name: partenaire in: query required: true description: Clé privée du partenaire schema: type: string - name: abonnement in: query description: | Restreint la liste aux titres auxquels le partenaire est abonné, via une collection ou une ressource. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: depuis in: query required: true description: | Timestamp (en secondes) à partir duquel lister les changements. Une date textuelle ("2019-01-20 12:30:00" ou "-1 week") est aussi possible, mais plus ambiguë. schema: type: string - name: possession in: query description: | Si `possession=1`, seuls les titres possédés par le partenaire seront concernés. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean responses: "200": description: Objet décrivant les ajouts, modifications, suppressions content: application/json: schema: $ref: "#/components/schemas/AccesChanges" /mes/titres: get: operationId: /mes/titres summary: Pour un partenaire de Mir@bel, liste des titres, par possession ou abonnement description: | Liste des titres de revues possédées par un partenaire de Mir@bel, et décrites par leur dernier titre. *L'accès est restreint aux partenaires de Mir@bel.* parameters: - name: partenaire in: query required: true description: Clé privée du partenaire schema: type: string - name: abonnement in: query description: | Restreint la liste aux titres auxquels le partenaire est abonné, via une collection ou une ressource. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: possession in: query description: | Si `possession=1`, seuls les titres possédés par le partenaire seront concernés. Les critères "abonnement" et "possession" sont cumulables (OU logique). schema: type: boolean - name: ressourceid in: query description: | Identifiant numérique d'une ressource de Mir@bel (par ex. `3` pour Cairn.info). Filtre supplémentaire schema: type: integer responses: "200": description: liste de titres content: application/json: schema: type: array items: $ref: "#/components/schemas/Titre" default: description: Erreur content: application/json: schema: $ref: "#/components/schemas/Erreur" servers: - url: https://reseau-mirabel.info/api components: schemas: Acces: type: object properties: id: type: integer description: Identifiant unique attribué par Mir@bel à cet accès en ligne. contenu: type: string description: Parmi "Intégral", "Résumé", "Sommaire", "Indexation". collections: type: array items: type: string description: Nom des éventuelles collections concernées, dans la ressource de cet accès. datedebut: type: string description: Date (YYYY ou YYYY-mm ou YYYY-mm-dd) de début d'accès. datefin: type: string description: Éventuelle date (YYYY ou YYYY-mm ou YYYY-mm-dd) de fin d'accès. dateinfo: type: string description: | Description textuelle de la date barrière. Si cette donnée n'est pas fournie par la source de l'accès, elle est déduite du champ 'embargoinfo'. Exemple de valeur : "Accès avant une date barrière mobile de 3 années calendaires". dernumurl: type: string description: URL pointant sur le dernier numéro de la revue. diffusion: type: string description: | Valeur parmi "libre", "restreint", "abonné". Cette dernière valeur n'est possible que si le paramètre "partenaire" est présent. embargoinfo: type: string description: Le contenu du champ `embargo_info`, si l'accès a été créé par un import KBART. identifiantpartenaire: type: string description: Si interrogation sur les possessions d'un partenaire, donne l'identifiant de possession. issn: type: array description: La liste des ISSN des titres de cet accès en ligne. Champ présent seulement si la recherche se fait par ISSN. items: type: string lacunaire: type: boolean description: Si vrai, des numéros sont manquants sur la période, donc la couverture n'est pas exhaustive. mailurl: type: string description: URL de la revue par alerte courriel. nodebut: type: integer nullable: true description: Null ou numérotation initiale, par exemple 6. nofin: type: integer nullable: true description: Null ou numérotation finale, par exemple 12. numerodebut: type: string description: Intitulé du numéro initial, par exemple "Vol. I, no 6". numerofin: type: string description: Intitulé du numéro final, par exemple "Vol. XXV, no 12 (HS)". ressource: type: string description: Nom de la ressource fournissant cet accès. ressourceid: type: integer description: Identifiant unique attribué par Mir@bel à la ressource de cet accès. ressourcesigle: type: string description: Nom bref (sigle ou acronyme) de la ressource. rssurl: type: string description: URL du flux RSS de la revue. selection: type: boolean description: Si vrai, un numéro est représenté par une sélection d'articles, donc la couverture n'est pas exhaustive. titreid: type: integer description: référence à Titre.id url: type: string description: URL de la revue. urlproxy: type: string description: | Si le partenaire est déclaré et que ses proxys sont actifs pour cet accès, alors ce champ contient l'URL avec application des proxys. Sinon, ce champ n'est pas présent. voldebut: type: integer description: Null, ou volume initial, par exemple 1. volfin: type: integer description: Null, ou volume final, par exemple 25. AccesChanges: description: | Trois champs. `creations` et `modifications` sont des listes d'accès. Et `suppressions` est une liste des ID d'accès supprimés (non-limitée aux revues possédées). type: object properties: creations: type: array items: $ref: "#/components/schemas/Acces" description: Liste des accès ajoutés. modifications: type: array items: $ref: "#/components/schemas/Acces" suppressions: type: array items: type: integer description: Identifiants (cf Acces.id) des accès supprimés. Editeur: required: ["id", "identifiants", "liens", "nom", "url_mirabel"] type: object properties: id: type: integer description: Identifiant unique attribué par Mir@bel à cet éditeur. identifiants: type: array items: type: string description: | Liste d'identifiants sous forme de couples [clé, valeur], par exemple `[["idref", "029524989"]]`. liens: type: array items: type: string description: Liste d'URL extérieures (Facebook, Twitter, etc) pour cet éditeur. nom: type: string description: Nom (sans son éventuel préfixe comme "L'"). pays: type: string description: Codes ISO à 3 lettres du pays de l'éditeur. prefixe: type: string description: Préfixe du nom de l'éditeur (par exemple "L'"). role: type: string description: Rôle général de l'éditeur pour ses titres. url: type: string description: Site web de l'éditeur. URL publique, hors Mir@bel. url_mirabel: type: string description: Page web de cet éditeur sur le site de Mir@bel. EditeurTitre: required: ["precedent"] type: object description: Les champs editeur* sont absents si la relation se rapporte à un éditeur connu. De même pour titre*. properties: editeur: type: string description: Nom de l'éditeur (sans son éventuel préfixe comme "L'"). editeur_id: type: integer description: Identifiant unique attribué par Mir@bel à cet éditeur. minimum: 1 precedent: type: boolean description: Il s'agit d'un éditeur précédent, qui n'intervient plus sur ce titre. role: type: string description: Rôle de l'éditeur spécifiquement pour ce titre. Champ absent s'il n'y a pas de rôle spécifique. titre: type: string description: Titre (sans son éventuel préfixe comme "L'"). titre_id: type: integer description: Identifiant unique attribué par Mir@bel à ce titre. minimum: 1 Issn: description: | Attributs identifiant un titre ou une revue. Cette structure contient généralement un ISSN, mais peut aussi ne donner que d'autres identifiants. type: object properties: bnfark: type: string description: Identifiant Ark de la BNF. issn: type: string description: | Ce champ sera absent si l'ISSN n'existe pas ou n'est pas connu, mais qu'un PPN (SUDOC) ou qu'un OCN (Worldcat) existe. issnl: type: string description: Éventuellemnt absent. statut: type: string description: Valeur parmi "en cours", "sans", "valide" sudocnoholding: type: boolean description: Si true, la notice du Sudoc n'est pas localisée. sudocppn: type: string description: Identifiant PPN du Sudoc. support: type: string description: Valeur parmi "inconnu", "papier", "electronique" worldcatocn: type: integer description: Identifiant OCN de Worldcat. Revue: description: Une revue est un historique de titres. type: object properties: id: type: integer description: Identifiant unique attribué par Mir@bel à cette revue. dermodif: type: integer description: Timestamp (secondes) de la dernière modification de la revue (incluant titres et accès). derverif: type: integer description: Timestamp (secondes) de la dernière vérification des données de la revue (incluant titres et accès) dans Mir@bel. titres: type: array items: $ref: "#/components/schemas/Titre" description: Historique des titres de la revue, triés du plus récent au plus ancient. Le premier est donc le titre actif. Theme: description: Un thème est un élément de la thématique utilisée par Mir@bel. type: object properties: id: type: integer description: Identifiant unique attribué par Mir@bel. La racine a l'identifiant 1. parentid: type: integer description: Identifiant du thème parent. 0 pour la racine, strictement positif sinon. nom: type: string description: Nom du thème. Titre: type: object properties: id: type: integer description: Identifiant unique attribué par Mir@bel à ce titre. bouquetpartenaire: type: string description: | Ce champ est présent si le titre a été produit par une recherche sur les possessions, par exemple dans la requête /mes/titres. Il contient le bouquet déclaré par le partenaire pour ce titre dans ses possessions. datedebut: type: string format: date description: Date de début de ce titre. datefin: type: string format: date description: Éventellement, date de fin de ce titre. editeurs: type: array items: type: string description: Liste des noms d'éditeurs actuels. Voir `relations_editeurs` pour une liste plus détaillée. identifiantpartenaire: type: string description: | Ce champ est présent si le titre a été produit par une recherche sur les possessions, par exemple dans la requête /mes/titres. Il contient l'identification local au partenaire pour ce titre, telle que déclaré dans ses possessions. issns: type: array items: $ref: "#/components/schemas/Issn" description: Liste des identifiants, notamment ISSN, attachés au titre. labellisation: type: array items: type: string description: Liste de textes parmi "DOAJ seal", "Catálogo 2.0 Latindex". langues: type: array items: type: string description: Liste des langues de ce titre, par leurs codes ISO à 3 lettres. liens: type: array items: type: string description: Liste d'URL extérieures (Facebook, Twitter, etc) pour ce titre. obsoletepar: type: integer description: Éventuel identifiant numérique du titre qui a remplacé celui-ci dans la revue. periodicite: type: string description: Périodicité. prefixe: type: string description: Préfixe du titre (par exemple "L'"). relations_editeurs: type: array items: $ref: "#/components/schemas/EditeurTitre" description: Ce champ n'est présent que dans les requêtes cherchant un titre unique, autrement dit /titres/{id}. revueid: type: integer description: Identifiant unique attribué par Mir@bel à cette revue (historique de titres). sigle: type: string description: Nom bref (sigle ou acronyme). titre: type: string description: Titre (sans son éventuel préfixe comme "L'"). url: type: string description: Site web de la revue. URL publique, hors Mir@bel. url_revue_mirabel: type: string description: Page web de la revue sur le site de Mir@bel. Erreur: type: object required: - code - message properties: code: type: integer format: int32 description: Code HTTP de l'erreur message: type: string description: Description détaillée du problème fields: type: string description: Éventuels champs créant un trouble dans la requête details: type: object description: Éventuels détails sur l'erreur. Redirection: type: object required: - code - nouvelid - url properties: code: type: integer format: int32 description: Code HTTP de la redirection (300 à 399) nouvelid: type: integer format: int32 description: identifiant de l'objet après redirection url: type: string description: url de l'objet après redirection