Interface de programmation (API)

Recherche

L'API de recherche de VASCAN accepte les requêtes de types GET et POST. Le URI contient la version de l'API et la ressource 'search' accepte un paramètre q. La valeur du paramètre q peut être un nom scientifique, un nom vernaculaire ou un identifiant de taxon VASCAN (e.g. 861). Elle peut contenir une seule valeur pour les requêtes de type GET ou plusieurs (maximum 200) pour les requêtes de type POST en les séparant avec un saut de ligne, \n. Les requêtes GET ayant un URI pointant vers une ressource JSON peuvent avoir un paramètre additionnel callback pour obtenir une réponse JSONP.

http://data.canadensys.net/vascan/api/0.1/search.json OU http://data.canadensys.net/vascan/api/0.1/search.xml

Paramètre

q
Nom scientifique, nom vernaculaire ou identifiant de taxon VASCAN. Utilisez un saut de ligne, \n entre les valeurs pour une requête de type POST. Précédez vos valeurs avec un identifiant local et une barre verticale, | (optionnel). e.g. ?q=Crataegus dodgei e.g. ?q=1004232|bleuet à feuilles étroites e.g. ?q=5031

Réponse

{
    apiVersion: "0.1",
    lastUpdatedDate: "YYYY-MM-DD",
    results: [
        {
            searchedTerm: "Crataegus dodgei",
            numMatches: 1,
            matches: [
                {
                    taxonID: 8673,
                    scientificName: "Crataegus dodgei Ashe",
                    scientificNameAuthorship: "Ashe",
                    canonicalName: "Crataegus dodgei",
                    taxonRank: "species",
                    taxonomicAssertions: [
                        {
                            acceptedNameUsage: "Crataegus dodgei Ashe",
                            acceptedNameUsageID: 8673,
                            nameAccordingTo: "FNA Editorial Committee. in prep. Flora of North America north of Mexico...etc",
                            nameAccordingToID: "",
                            taxonomicStatus: "accepted",
                            parentNameUsageID: 2408,
                            higherClassification: "Equisetopsida;Magnoliidae;Rosanae;Rosales;Rosaceae;Spiraeoideae;Pyreae;Crataegus;Crataegus sect. Coccineae;Crataegus ser. Rotundifoliae"
                        }
                    ],
                    vernacularNames: [
                        {
                            vernacularName: "aubépine de Dodge",
                            language: "fr",
                            source: "McMurray, S. & A. Lehela. 1999. Ontario Plant List - Digital Version 1.0...etc",
                            preferredName: true
                        },
                        {
                            vernacularName: "Dodge's hawthorn",
                            language: "en",
                            source: "",
                            preferredName: true
                        },
                        {
                            vernacularName: "aubépine jaunâtre",
                            language: "fr",
                            source: "Cuerrier, A. Proposition de nom français. (pers. comm.)",
                            preferredName: false
                        },
                        {
                            vernacularName: "yellowish hawthorn",
                            language: "en",
                            source: "Anions, M., Director of Science, NatureServe Canada (pers. comm.)",
                            preferredName: false
                        },
                        {
                            vernacularName: "yellowish Dodge's hawthorn",
                            language: "en",
                            source: "FNA Editorial Committee. in prep. Flora of North America north of Mexico. Volume 17...etc",
                            preferredName: false
                        }
                    ],
                    distribution: [
                        {
                            locationID: "ISO 3166-2:CA-ON",
                            locality: "ON",
                            establishmentMeans: "native",
                            occurrenceStatus: "native"
                        },
                        {
                            locationID: "ISO 3166-2:CA-QC",
                            locality: "QC",
                            establishmentMeans: "native",
                            occurrenceStatus: "native"
                        }
                    ]
                }
            ]
        }
    ]
}

OpenRefine

Utilisez OpenRefine pour réconcilier vos noms scientifiques ou vernaculaires avec VASCAN.

http://data.canadensys.net/vascan/refine/0.1/reconcile

R Project - Taxize

Utilisez Taxize pour réconcilier vos noms scientifiques ou vernaculaires avec VASCAN.

https://cran.r-project.org/web/packages/taxize/index.html