API et modules

API vèrb'Òc - Mode d'emploi

L'API vèrb'Òc vous permet, pour un infinitif occitan, d'obtenir sa conjugaison. Vous pouvez préciser la personne, le mode, le temps...

L'URL d'entrée

L'URL de base de l'application est http://api.locongres.org/verboc.php. Vous devez y ajouter les paramètres obligatoires et vous pouvez y ajouter des paramètres facultatifs. Si vous ne savez pas ajouter des paramètres à un URL, nous vous renvoyons à ce tutoriel.

Les paramètres obligatoires

Il vous faut obligatoirement indiquer les paramètres suivants :

  • Votre clé API : pour utiliser les API du Congrès, il vous faut indiquer une clé API personnelle que nous pouvons vous fournir sur la page dédiée. Vous l'indiquez avec le paramètre "key".
  • L'infinitif : indiquez l'infinitif du verbe à conjuguer avec le paramètre "inf" qui prend en valeur un verbe occitan à l'infinitif.
  • La variété : indiquez dans quelle variété de l'occitan vous voulez les conjugaisons avec le paramètre "var". Pour le moment, il accepte les valeurs "gascon" (pour l'occitan gascon) et "lengadoc" (pour l'occitan languedocien).

Par exemple, vous pouvez afficher toutes les conjugaisons du verbe "cantar" en languedocien avec l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=cantar&var=lengadoc. Vous obtenez le résultat suivant :

{
    "query": [
        {
            "form": "cantariam",
            "id": 105852,
            "per": "1",
            "num": "pl",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantariatz",
            "id": 105853,
            "per": "2",
            "num": "pl",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantari\u00e1n",
            "id": 105854,
            "per": "3",
            "num": "pl",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantari\u00e1i",
            "id": 105849,
            "per": "1",
            "num": "sg",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantari\u00e1s",
            "id": 105850,
            "per": "2",
            "num": "sg",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantari\u00e1",
            "id": 105851,
            "per": "3",
            "num": "sg",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "cantem",
            "id": 105856,
            "per": "1",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "a"
        },
        {
            "form": "cantatz",
            "id": 105857,
            "per": "2",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "a"
        },
        {
            "form": "canta",
            "id": 105855,
            "per": "2",
            "num": "sg",
            "mod": "imp",
            "tns": "pres",
            "pol": "a"
        },
        {
            "form": "cantem",
            "id": 105859,
            "per": "1",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "cantetz",
            "id": 105860,
            "per": "2",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "cantes",
            "id": 105858,
            "per": "2",
            "num": "sg",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "cantarem",
            "id": 105846,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cantaretz",
            "id": 105847,
            "per": "2",
            "num": "pl",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cantar\u00e0n",
            "id": 105848,
            "per": "3",
            "num": "pl",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cantarai",
            "id": 105843,
            "per": "1",
            "num": "sg",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cantar\u00e0s",
            "id": 105844,
            "per": "2",
            "num": "sg",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cantar\u00e0",
            "id": 105845,
            "per": "3",
            "num": "sg",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "cant\u00e0vem",
            "id": 105828,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cant\u00e0vetz",
            "id": 105829,
            "per": "2",
            "num": "pl",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cantavan",
            "id": 105830,
            "per": "3",
            "num": "pl",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cantavi",
            "id": 105825,
            "per": "1",
            "num": "sg",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cantavas",
            "id": 105826,
            "per": "2",
            "num": "sg",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cantava",
            "id": 105827,
            "per": "3",
            "num": "sg",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8rem",
            "id": 105822,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cant\u00e8retz",
            "id": 105823,
            "per": "2",
            "num": "pl",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cant\u00e8ron",
            "id": 105824,
            "per": "3",
            "num": "pl",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cant\u00e8ri",
            "id": 105819,
            "per": "1",
            "num": "sg",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cant\u00e8res",
            "id": 105820,
            "per": "2",
            "num": "sg",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cant\u00e8t",
            "id": 105821,
            "per": "3",
            "num": "sg",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "cantam",
            "id": 105816,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "cantatz",
            "id": 105817,
            "per": "2",
            "num": "pl",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "cantan",
            "id": 105818,
            "per": "3",
            "num": "pl",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "canti",
            "id": 105813,
            "per": "1",
            "num": "sg",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "cantas",
            "id": 105814,
            "per": "2",
            "num": "sg",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "canta",
            "id": 105815,
            "per": "3",
            "num": "sg",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "cantar",
            "id": 105861,
            "mod": "inf"
        },
        {
            "form": "cantada",
            "id": 105864,
            "gen": "f",
            "num": "sg",
            "mod": "part",
            "tns": "pas"
        },
        {
            "form": "cantat",
            "id": 105863,
            "gen": "m",
            "num": "sg",
            "mod": "part",
            "tns": "pas"
        },
        {
            "form": "cantant",
            "id": 105862,
            "mod": "part",
            "tns": "pres"
        },
        {
            "form": "cant\u00e8ssem",
            "id": 105840,
            "per": "1",
            "num": "pl",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8ssetz",
            "id": 105841,
            "per": "2",
            "num": "pl",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8sson",
            "id": 105842,
            "per": "3",
            "num": "pl",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8sse",
            "id": 105837,
            "per": "1",
            "num": "sg",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8sses",
            "id": 105838,
            "per": "2",
            "num": "sg",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cant\u00e8sse",
            "id": 105839,
            "per": "3",
            "num": "sg",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "cantem",
            "id": 105834,
            "per": "1",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "cantetz",
            "id": 105835,
            "per": "2",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "canten",
            "id": 105836,
            "per": "3",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "cante",
            "id": 105831,
            "per": "1",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "cantes",
            "id": 105832,
            "per": "2",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "cante",
            "id": 105833,
            "per": "3",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        }
    ]
}

Les paramètres facultatifs

La personne et le nombre

Vous pouvez demander seulement les conjugaisons d'une personne en passant en paramètre la personne et le nombre.

Le paramètre de personne "per" prend en valeur "1", "2" ou "3".

Le paramètre de nombre "num" prend en valeur "sg" (singulier) ou "pl" (pluriel).

Par exemple, vous pouvez afficher toutes les conjugaisons à la première personne du pluriel du verbe "aviar" en occitan gascon avec l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=aviar&var=gascon&per=1&num=pl. Vous obtenez le résultat suivant :

{
    "query": [
        {
            "form": "aviarem",
            "id": 1305813,
            "per": "1",
            "num": "pl",
            "mod": "cond",
            "tns": "pres"
        },
        {
            "form": "aviem",
            "id": 1305817,
            "per": "1",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "a"
        },
        {
            "form": "aviem",
            "id": 1305820,
            "per": "1",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "aviaram",
            "id": 1305807,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "fut"
        },
        {
            "form": "avi\u00e0vam",
            "id": 1305789,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "imp"
        },
        {
            "form": "avi\u00e8m",
            "id": 1305783,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "pas"
        },
        {
            "form": "aviam",
            "id": 1305777,
            "per": "1",
            "num": "pl",
            "mod": "ind",
            "tns": "pres"
        },
        {
            "form": "avi\u00e8ssem",
            "id": 1305801,
            "per": "1",
            "num": "pl",
            "mod": "subj",
            "tns": "imp"
        },
        {
            "form": "aviem",
            "id": 1305795,
            "per": "1",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        }
    ]
}

Le mode et le temps

Pour n'avoir que les conjugaisons à un temps et/ou un mode, vous pouvez utiliser les paramètres "mod" et "tns".

Le paramètre de mode "mod" peut prendre les valeurs suivantes :

  • "ind" : indicatif
  • "subj" : subjonctif
  • "cond" : conditionnel
  • "imp" : impératif
  • "inf" : infinitif
  • "part" : participe

Le paramètre de temps "tns" peut prendre les valeurs suivantes :

  • "pres" : présent
  • "pas" : passé / prétérit
  • "imp" : imparfait
  • "fut" : futur

Par exemple, si vous voulez les conjugaisons au présent du subjonctif de "mostrar" en occitan languedocien, vous pouvez utiliser l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=mostrar&var=lengadoc&mod=subj&tns=pres. Vous obtenez le résultat suivant :

{
    "query": [
        {
            "form": "mostrem",
            "id": 396362,
            "per": "1",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "mostretz",
            "id": 396363,
            "per": "2",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "m\u00f2stren",
            "id": 396364,
            "per": "3",
            "num": "pl",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "m\u00f2stre",
            "id": 396359,
            "per": "1",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "m\u00f2stres",
            "id": 396360,
            "per": "2",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        },
        {
            "form": "m\u00f2stre",
            "id": 396361,
            "per": "3",
            "num": "sg",
            "mod": "subj",
            "tns": "pres"
        }
    ]
}

Les combinaisons possibles entre mode et temps sont les suivantes :

  • Indicatif présent
  • Indicatif imparfait
  • Indicatif prétérit
  • Indicatif futur
  • Subjonctif présent
  • Subjonctif imparfait
  • Conditionnel présent
  • Impératif présent (affirmatif ou négatif, voir ci-dessous)
  • Infinitif
  • Participe présent
  • Participe passé

Le genre et le nombre

Pour le participe passé, vous pouvez préciser le genre et le nombre.

Pour indiquer le genre, utilisez le paramètre "gen" qui peut prendre les valeurs "f" (féminin) ou "m" (masculin).

Pour indiquer le nombre, utilisez le paramètre "num" qui peut prendre les valeurs"sg" (singulier) ou "pl" (pluriel).

Par exemple, si vous voulez les conjugaisons au participe passé masculin singulier de "faire" en occitan languedocien, vous pouvez utiliser l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=faire&var=lengadoc&mod=part&tns=pas&gen=m&num=sg. Vous obtenez le résultat suivant :

{
    "query": [
        {
            "form": "fach",
            "id": 1445,
            "gen": "m",
            "num": "sg",
            "mod": "part",
            "tns": "pas"
        },
        {
            "form": "fait",
            "id": 1447,
            "gen": "m",
            "num": "sg",
            "mod": "part",
            "tns": "pas"
        }
    ]
}

La polarité

Pour l'impératif, vous pouvez avoir besoin d'indiquer si vous désirez celui utilisé dans les phrases affirmatives ou celui utilisé dans les phrases négatives.

Pour ce faire, il vous faut utiliser le paramètre "pol" qui prend pour valeur "a" (phrase affirmative) ou "n" (phrase négative).

Par exemple, si vous voulez les conjugaisons à l'impératif négatif de "tornar" en occitan gascon, vous pouvez utiliser l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=tornar&var=gascon&mod=imp&tns=pres&pol=n. Vous obtenez le résultat suivant :

{
    "query": [
        {
            "form": "tornem",
            "id": 947641,
            "per": "1",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "tornetz",
            "id": 947642,
            "per": "2",
            "num": "pl",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        },
        {
            "form": "tornes",
            "id": 947640,
            "per": "2",
            "num": "sg",
            "mod": "imp",
            "tns": "pres",
            "pol": "n"
        }
    ]
}

Afficher un verbe au hasard

Si vous voulez que le verbe dont vous cherchez les conjugaisons soit choisi au hasard, il vous faut indiquer la valeur "random" pour le paramètre "inf".

Par exemple, si vous voulez la conjugaison à la première personne du singulier du présent de l'indicatif d'un verbe choisi au hasard en occitan languedocien, vous pouvez utiliser l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&var=lengadoc&inf=random&format=xml&per=1&num=sg&mod=ind&tns=pres. Vous obtenez quelque chose comme :

{
    "query": [
        {
            "form": "coblegi",
            "id": 125261,
            "per": "1",
            "num": "sg",
            "mod": "ind",
            "tns": "pres"
        }
    ]
}

Le format de sortie

Par défaut, le format de sortie est JSON. Mais vous pouvez obtenir une sortie au format XML en ajoutant "format=xml" à l'URL.

Par exemple, si vous voulez les conjugaisons du verbe "plaire" en occitan languedocien au format XML, vous pouvez utiliser l'URL http://api.locongres.org/verboc.php?key=[votre_clé_API]&inf=plaire&var=lengadoc&format=xml. Vous obtenez le résultat suivant :

<query>
    <form id="618607">
        <orth>plairiam</orth>
        <per>1</per>
        <num>pl</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618608">
        <orth>plairiatz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618609">
        <orth>plairián</orth>
        <per>3</per>
        <num>pl</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618604">
        <orth>plairiái</orth>
        <per>1</per>
        <num>sg</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618605">
        <orth>plairiás</orth>
        <per>2</per>
        <num>sg</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618606">
        <orth>plairiá</orth>
        <per>3</per>
        <num>sg</num>
        <mod>cond</mod>
        <tns>pres</tns>
    </form>
    <form id="618611">
        <orth>plagam</orth>
        <per>1</per>
        <num>pl</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>a</pol>
    </form>
    <form id="618612">
        <orth>plasètz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>a</pol>
    </form>
    <form id="618610">
        <orth>plai</orth>
        <per>2</per>
        <num>sg</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>a</pol>
    </form>
    <form id="618614">
        <orth>plagam</orth>
        <per>1</per>
        <num>pl</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>n</pol>
    </form>
    <form id="618615">
        <orth>plagatz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>n</pol>
    </form>
    <form id="618613">
        <orth>plagas</orth>
        <per>2</per>
        <num>sg</num>
        <mod>imp</mod>
        <tns>pres</tns>
        <pol>n</pol>
    </form>
    <form id="618601">
        <orth>plairem</orth>
        <per>1</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618602">
        <orth>plairetz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618603">
        <orth>plairàn</orth>
        <per>3</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618598">
        <orth>plairai</orth>
        <per>1</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618599">
        <orth>plairàs</orth>
        <per>2</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618600">
        <orth>plairà</orth>
        <per>3</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>fut</tns>
    </form>
    <form id="618583">
        <orth>plasiam</orth>
        <per>1</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618584">
        <orth>plasiatz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618585">
        <orth>plasián</orth>
        <per>3</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618580">
        <orth>plasiái</orth>
        <per>1</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618581">
        <orth>plasiás</orth>
        <per>2</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618582">
        <orth>plasiá</orth>
        <per>3</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>imp</tns>
    </form>
    <form id="618577">
        <orth>plaguèrem</orth>
        <per>1</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618578">
        <orth>plaguèretz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618579">
        <orth>plaguèron</orth>
        <per>3</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618574">
        <orth>plaguèri</orth>
        <per>1</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618575">
        <orth>plaguères</orth>
        <per>2</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618576">
        <orth>plaguèt</orth>
        <per>3</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pas</tns>
    </form>
    <form id="618571">
        <orth>plasèm</orth>
        <per>1</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618572">
        <orth>plasètz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618573">
        <orth>plason</orth>
        <per>3</per>
        <num>pl</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618568">
        <orth>plasi</orth>
        <per>1</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618569">
        <orth>plases</orth>
        <per>2</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618570">
        <orth>plai</orth>
        <per>3</per>
        <num>sg</num>
        <mod>ind</mod>
        <tns>pres</tns>
    </form>
    <form id="618616">
        <orth>plaire</orth>
        <mod>inf</mod>
    </form>
    <form id="618619">
        <orth>plaguda</orth>
        <gen>f</gen>
        <num>sg</num>
        <mod>part</mod>
        <tns>pas</tns>
    </form>
    <form id="618618">
        <orth>plagut</orth>
        <gen>m</gen>
        <num>sg</num>
        <mod>part</mod>
        <tns>pas</tns>
    </form>
    <form id="618617">
        <orth>plasent</orth>
        <mod>part</mod>
        <tns>pres</tns>
    </form>
    <form id="618595">
        <orth>plaguèssem</orth>
        <per>1</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618596">
        <orth>plaguèssetz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618597">
        <orth>plaguèsson</orth>
        <per>3</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618592">
        <orth>plaguèsse</orth>
        <per>1</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618593">
        <orth>plaguèsses</orth>
        <per>2</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618594">
        <orth>plaguèsse</orth>
        <per>3</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>imp</tns>
    </form>
    <form id="618589">
        <orth>plagam</orth>
        <per>1</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
    <form id="618590">
        <orth>plagatz</orth>
        <per>2</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
    <form id="618591">
        <orth>plagan</orth>
        <per>3</per>
        <num>pl</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
    <form id="618586">
        <orth>plaga</orth>
        <per>1</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
    <form id="618587">
        <orth>plagas</orth>
        <per>2</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
    <form id="618588">
        <orth>plaga</orth>
        <per>3</per>
        <num>sg</num>
        <mod>subj</mod>
        <tns>pres</tns>
    </form>
</query>

Les erreurs

S'il y a des erreurs dans l'URL ou si la requête ne retourne aucune forme, l'API retourne une erreur avec un code et un texte d'erreur en anglais. Vous trouverez ci-dessous, pour chaque code d'erreur, la traduction de son texte en français :

  • 1 : Vous devez indiquer une clé API
  • 2 : Clé API invalide
  • 3 : Format incorrect ("json" et "xml" acceptés)
  • 4 : Vous devez indiquer un infinitif
  • 5 : Vous devez indiquer une variété
  • 6 : Variété incorrecte ("lengadoc" et "gascon" acceptés)
  • 7 : Personne incorrecte ("1", "2", e "3" acceptés)
  • 8 : Temps incorrect ("pres", "pas", "imp" e "fut" acceptés)
  • 9 : Mode incorrect ("ind", "subj", "cond", "imp", "inf" e "part" acceptés)
  • 10 : Genre incorrect ("f" e "m" acceptés)
  • 11 : Nombre incorrect ("sg" e "pl" acceptés)
  • 12 : Polarité incorrecte ("a" e "n" acceptés)
  • 13 : Combinaison temps-mode incorrecte
  • 14 : L'infinitif et le participe ne permettent pas de condition de personne
  • 15 : L'impératif permet seulement les combinaisons personne-nombre suivantes : 2-sg, 1-pl e 2-pl
  • 16 : Seul l'impératif permet une condition de polarité
  • 17 : Seul le participe passé permet une condition de genre
  • 18 : L'infinitif et le participe présent ne permettent pas de condition de nombre
  • 19 : Nous n'avons trouvé aucune forme avec vos spécifications

Les informations en sortie

En sortie, vous obtenez une liste de formes avec un identifiant unique. Pour chacune est donné(e) :

  • Son orthographe
  • Son infinitif
  • *La personne : "1", "2" ou "3"
  • *Le nombre : "sg" (singulier) ou "pl" (pluriel)
  • *Le genre : "f" (féminin) ou "m" (masculin)
  • Le mode : "ind" (indicatif), "subj" (subjonctif), "cond" (conditionnel), "imp" (impératif), "inf" (infinitif) ou "part" (participe)
  • *Le temps : "pres" (présent), "pas" (passé ou prétérit), "imp" (imparfait) ou "fut" (futur)
  • *La polarité : "a" (affirmative) ou "n" (négative)
  • *La distinction : si deux verbes ont le même infinitif, vous pouvez utiliser la distinction pour les différencier. Ce champ propose une description du verbe avec quatre de ses conjugaisons : première personne du singulier au présent de l'indicatif, troisième personne du singulier au présent de l'indicatif, première personne du singulier à l'imparfait de l'indicatif, participe passé masculin singulier.

Les champs précédés de * n'apparaissent pas obligatoirement.

JSON schema

{
    "type": "object",
    "properties": {
        "error": {
            "type": "object",
            "properties": {
                "code": {
                    "description": "The unique identifier for an error",
                    "type": "integer"
                },
                "text": {
                    "description": "A description of the error",
                    "type": "string"
                }
            },
            "required": ["code", "text"]
        },
        "query": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "form": {
                        "type": "string"
                    },
                    "inf": {
                        "type": "string"
                    },
                    "per": {
                        "type": "string"
                    },
                    "num": {
                        "type": "string"
                    },
                    "mod": {
                        "type": "string"
                    },
                    "tns": {
                        "type": "string"
                    },
                    "gen": {
                        "type": "string"
                    },
                    "pol": {
                        "type": "string"
                    },
                    "dist": {
                        "type": "string"
                    },
                },
                "required": ["id", "form", "mod"]
            },
            "minItems": 1
        }
    }
}

DTD XML

<! ELEMENT query (form) >

<! ELEMENT error (#PCDATA) >
<! ATTLIST error code ID #REQUIRED >

<! ELEMENT form (dist?, gen?, inf, mod, num?, orth, per?, pol?, tns?) >
<! ATTLIST form id ID #REQUIRED >

<! ELEMENT dist (#PCDATA) >

<! ELEMENT gen (#PCDATA) >

<! ELEMENT inf (#PCDATA) >

<! ELEMENT mod (#PCDATA) >

<! ELEMENT num (#PCDATA) >

<! ELEMENT orth (#PCDATA) >

<! ELEMENT per (#PCDATA) >

<! ELEMENT pol (#PCDATA) >

<! ELEMENT tns (#PCDATA) >

© Lo Congrès Permanent de la Lenga Occitana, 2017, tous droits réservés - Contacter Lo Congrès