Download - Application Programming Interface
APPLICATION PROGRAMMING INTERFACE
SANTIAGO MARTÍNEZ DE LA [email protected]
Unidad de Coordinación GBIF.esTaller de Formación del Portal
Internacional GBIF.ORG
API
ÍNDICE_
1. ¿Qué es una API?• Explicación.• Respuestas.
Formato. Manejo.
• Ejemplos y Aplicaciones.
2. APIs de GBIF.org:• Introducción.• Información a
consultar: A nivel del
Registro. A nivel de las
Especies. A nivel de
Especímenes y Observaciones.
A nivel de Mapa.
- Es una interfaz de comunicación entre un servidor y sus clientes.
- Este interfaz de comunicación (API), nos proporciona un lenguaje para poder comunicarnos con el servidor, de manera que podamos establecer una conversación con él, y así poder obtener información del mismo.
- El lenguaje a través del cual nos comunicamos con el servidor, tiene un formato específico de cada servidor.
1. ¿Qué es una API? (wiki)
APPLICATION PROGRAMMING INTERFACE
- FORMATO:
1. ¿Qué es una API?
APPLICATION PROGRAMMING INTERFACE
http://api.gbif.org/v0.9/ dataset ? q=VAL & country=SPAIN
Nombre de la API(Constate)
Etiqueta ParámetrosAtributo=Valor
Concatena los parámetros
Indicador
- FLUJO DE INFORMACIÓN:
1. ¿Qué es una API?
APPLICATION PROGRAMMING INTERFACE
SERVIDOR
S.I CLIEN
TEAPI(Lenguaje
de comunicación)
http://api.gbif.org/v0.9/dataset?q=VAL&country=SPAIN 1
2
34
Respuesta
(JSON)
• Sistema de registro• GBIF Taxonomic
Backbone (nub) (y otras checklist)
• GBIF Occurrence Storage• Sistemas de
georreferenciación
SolicitudAnálisis
5Visualizació
n/
Lectura de la
respuesta
-CRUD-
{"offset":0,"limit":20,"endOfRecords":true,"results":
[{"key":2435099, "kingdom":"Animalia", "phylum":"Chordata", "clazz":"Mammalia", "order":"Carnivora","family":"Felidae","genus":"Puma","species":"Pumaconcolor","kingdomKey":1,"phylumKey":44,"classKey":359,"orderKey":732,"familyKey":9703,"genusKey":2435098,"speciesKey":2435099,"datasetKey":"d7dddbf4-2cf0-4f39-9b2a-bb099caae36c", "nubKey":2435099,"parentKey":2435098,"parent":"Puma","scientificName":"Puma con color (Linnaeus, 1771)","canonicalName":"Puma concolor“ ,"vernacularName":"Puma", "authorship":"(Linnaeus,1771)“ ,"nameType":"WELLFORMED","rank":"SPECIES", "origin":"SOURCE", "taxonomicStatus":"ACCEPTED", "nomenclaturalStatus":[],"publishedIn":"Mantissa Plantarum vol. 2 p. 266","accordingTo":"The Catalogue of Life, 3rd January 2011", "numDescendants":6, "identifiers":[{"key":1155098,"usageKey":2435099,"datasetKey":"d7dddbf4-2cf0-4f39-9b2a-bb099caae36c","identifier":"119806678","type":"SOURCE_ID"}],"synonym":false, "sourceId":"119806678"}, …,{}]}
APPLICATION PROGRAMMING INTERFACE
1. ¿Qué es una API?
- FORMATO LIGERO DE INTERCAMBIO DE DATOS (JSON):
-MANEJO DE LA RESPUESTA: http://161.111.171.204/apidataportal.php
1. ¿Qué es una API?
APPLICATION PROGRAMMING INTERFACE
- EJEMPLOS y APLICACIONES:
1. API del Open Geospatial Consortium (OGC) aportadas por actores participantes en el proyecto IDEE. http://www.idee.es/web/guest/ejemplos-de-api
2. API de Google Maps: Sitio Oficial y Documentación.
3. Youtube: Sitio Oficial y Documentación.
4. Amazon S3: Sitio Oficial y Documentación.
5. Facebook: Sitio Oficial y Documentación.
6. Flickr: Sitio Oficial y Documentación.
SISTEMA DE REGISTRO - DATASET
APPLICATION PROGRAMMING INTERFACE(API)
URL Método Respuesta Descripción Auth Paging Parámetros
/dataset GETListado de los dataset.
Lista todos los dataset del S.I. NO SI
(Explicación)
q, country, type, identifier, identifierType
/dataset POST UUID Crea un nuevo dataset SI NO
/dataset/{UUID} GET Detalles de MA
Detalles del dataset. NO NO
/dataset/{UUID} PUT Actualiza el dataset. SI NO
/dataset/{UUID} DELETE Borra el dataset. SI NO
DATASET
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/contact GET Contactos de
UNEXLista de contactos del dataset. NO NO
/dataset/{UUID}/contact POST ID Crea y añade un
nuevo contacto. SI NO
/dataset/{UUID}/contact/{ID} PUT Actualiza el
contacto. SI NO
/dataset/{UUID}/contact/{ID} DELETE Borra el contacto SI NO
DATASET + CONTACTOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/endpoint GET Endpoints
del Herbario LEB
Lista de puntos de acceso. NO NO
/dataset/{UUID}/endpoint POST ID Crea y añade un nuevo punto
de acceso. SI NO
/dataset/{UUID}/endpoint/{ID} DELETE Borra el punto de acceso. SI NO
DATASET + ENDPOINTS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/identifier GET Lista de
identificadores de BC
Lista de identificadores. NO NO
/dataset/{UUID}/identifier POST ID Crea y añade un nuevo
identificador. SI NO
/dataset/{UUID}/identifier/{ID} DELETE Borra el identificador. SI NO
DATASET + IDENTIFICADORES
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/tag GET Tags de Bos-odo
Lista de todas las etiquetas. NO NO
/dataset/{UUID}/tag POST ID Crea y añade un nueva etiqueta. SI NO
/dataset/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO
DATASET + ( TAGS / MACHINE TAGS) (explicación)
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/machinetag GET Machinetags
de Bos-odoLista de todas las etiquetas. NO NO
/dataset/{UUID}/machinetag POST ID Crea y añade un
nueva etiqueta. SI NO
/dataset/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/comment GET Comentarios s
obre el Herbario
EMMA
Lista de comentarios. NO NO
/dataset/{UUID}/comment POST ID Crea y añade un nuevo
comentario. SI NO
/dataset/{UUID}/comment/{ID}
DELETE Borra el comentario. SI NO
SISTEMA DE REGISTRO
DATASET + COMENTARIOS
URL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/constituents
GET Subdataset de MCNM-Cord
Lista todos los subdataset. (parentDatasetKey)
NO SI
SISTEMA DE REGISTRO
DATASET + SUBDATASET
DATASET + METADATAURL Método Respuesta Descripción Auth Paging
/dataset/{UUID}/document
GET EML de Sinfonevada. EML del dataset. NO NO
/dataset/{UUID}/document
POSTActualiza el EML del dataset reemplazando el antiguo..
SI NO
URL Método Respuesta Descripción Auth Paging Parámetros
/dataset/{UUID}/metadata GET Metadatos
de nzor
Visualiza los metadatos. NO NO Type
(DC, EML)
/dataset/metadata/{ID} GET Metadatos
del checklist de
nzor
Devuelve la descripción con ese ID.
NO NO
/dataset/metadata/{ID}/document
GET EMLDevuelve el documento asociado.
NO NO
/dataset/metadata/{ID}/ DELETE Borra el
metadato. SI NO
DATASET type = METADATA
SISTEMA DE REGISTRO
URL Método Respuesta Auth Paging
/dataset/deleted GET Lista de borrados NO SI
/dataset/duplicate GET Lista de dataset duplicados
NO SI
/dataset/withNoEndpoint GET Lista de los dataset que no tienen puntos de acceso
NO SI
SISTEMA DE REGISTRO
DATASET
URL Método Respuesta Descripción Paging Parámetros
/dataset/search
GETDataset que contengan la palabra
plant y se hayan publicado en España, en el 2010
Búsqueda sobre todo el listado de dataset. El resultado se ordena por relevancia.
SIq, country, type
, keyword,owning_org,hosting_org, decade,publishing_country,
/dataset/suggest
GET Dataset de BC publicados por GBIF
España
Devuelve los 20 primeros dataset, ordenados por relevancia.
SI
q, country, type, keyword,
owning_org (uuid),hosting_org(uuid), decade,
publishing_country,
BÚSQUEDA DE DATASET
SISTEMA DE REGISTRO
NOTA: Keywords = Tags + keywordCollections + temporalCoverages
URL Método Respuesta Descripción Paging
/dataset_metrics/{UUID} GET
Estadísticas de GBIF Taxonomy Backbone
Devuelve varios datos estadísticos de una checklist. • Número de especies.• Número de sinónimos.• Cuenta por rangos.• Cantidad de nombres
vernáculos por idioma,…
SI
DATOS ESTADÍSTICOS DEL DATASET (type = checklist)
SISTEMA DE REGISTRO
SISTEMA DE REGISTRO - INSTALACIONES
APPLICATION PROGRAMMING INTERFACE(API)
URL Método Respuesta Descripción Auth Paging Parámetros
/installation GET Lista Lista todas las instalaciones. NO SI
q, identifier, identifierType
/installation POST UUID Crea una nueva instalación SI NO
/installation/{UUID} GET Instalación
IPT de GBIF.es
Detalles de la instalación. NO NO
/installation/{UUID} PUT Actualiza la
instalación. SI NO
/installation/{UUID} DELETE Borra la
instalación. SI NO
INSTALACIONES
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/contact GET Contactos de
la instalación de GBIF.es
Lista de contactos de la instalación. NO NO
/installation/{UUID}/contact POST ID Crea y añade un
nuevo contacto. SI NO
/installation/{UUID}/contact/{ID} PUT Actualiza el
contacto. SI NO
/installation/{UUID}/contact/{ID} DELETE Borra el contacto SI NO
INSTALACIONES + CONTACTOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/endpoint
GET rss Lista los puntos de acceso de la instalación. NO NO
/installation/{UUID}/endpoint
POST ID Crea y añade un nuevo punto de acceso a la instalación. SI NO
/installation/{UUID}/endpoint/{ID}
DELETE Borra el punto de acceso de la instalación. SI NO
INSTALACIONES + ENDPOINTS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/identifier GET Listado de los id
entificadores de GBIF Francia.
Lista de identificadores de la instalación. NO NO
/installation/{UUID}/identifier POST ID
Crea y añade un nuevo identificador a la instalación.
SI NO
/installation/{UUID}/identifier/{ID}
DELETE Borra el identificador de la instalación. SI NO
SISTEMA DE REGISTRO
INSTLACIONES + IDENTIFICADORES
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/tag GET Tags de GBIF.es Lista todas las
etiquetas de la inst. NO NO
/installation/{UUID}/tag POST ID Crea y añade un nueva
etiqueta. SI NO
/installation/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO
INSTALACIONES + ( TAGS / MACHINE TAGS)
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/machinetag GET Machinetag de
l herbario Tapir de SANT
Lista todas las etiquetas máq. NO NO
/installation/{UUID}/machinetag POST ID Crea y añade un nueva
etiqueta. SI NO
/installation/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/comment
GET Comentarios de la instalación de GBIF Francia
Lista los comentarios sobre la instalación. NO NO
/installation/{UUID}/comment
POST IDCrea y añade un nuevo comentario asociado a la instalación.
SI NO
/installation/{UUID}/comment/{ID}
DELETE Borra un comentario. SI NO
SISTEMA DE REGISTRO
INSTALACIONES + COMENTARIOS
URL Método Respuesta Descripción Auth Paging
/installation/{UUID}/dataset GET
Dataset servidos a través del IPT de GBIF.es
,TAPIR,
Lista todos los dataset servidos a través de esa instalación.
NO SI
/installation/deleted GET Lista todas
las instalaciones marcadas como borradas.
NO SI
/installation/nonPublishing GET Lista todas las instalaciones
que sirven 0 dataset NO SI
SISTEMA DE REGISTRO
INSTALACIONES
APPLICATION PROGRAMMING INTERFACE(API)
SISTEMA DE REGISTRO - ORGANIZACIONES
URL Método Respuesta Descripción Auth Paging Parámetros
/organization GET Lista todas las organizaciones.
NO SI q, identifier, identifierType
/organization POST UUID Crea una nueva organización. SI NO
/organization/{UUID} GET Información
de la Universidad de León ,LEB.
Devuelve información sobre la organización.
NO NO
/organization/{UUID} PUT
Actualiza información de la organización.
SI NO
/organization/{UUID} DELETE Borra la
organización. SI NO
ORGANIZACIONES
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/contact GET Contactos
del Herbario de UNEX
Lista los contactos de la organización. NO NO
/organization/{UUID}/contact POST ID Crea y añade un
nuevo contacto. SI NO
/organization/{UUID}/contact/{ID} PUT Actualiza el
contacto. SI NO
/organization/{UUID}/contact/{ID} DELETE Borra el contacto SI NO
ORGANIZACIONES + CONTACTOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/endpoint
GET Endpoints del Instituto de la Universidad de Alicante.
Lista los puntos de acceso de la organización.
NO NO
/organization/{UUID}/endpoint
POST IDCrea y añade un nuevo punto de acceso a la organización.
SI NO
/organization/{UUID}/endpoint/{ID}
DELETEBorra un punto de acceso de la organización.
SI NO
ORGANIZACIONES + ENDPOINTS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/identifier GET Identificadores de
l CIBIO
Lista los identificadores de la organización.
NO NO
/organization/{UUID}/identifier POST ID
Crea y añade un nuevo identificador a la organización.
SI NO
/organization/{UUID}/identifier/{ID}
DELETE Borra un identificador de la organización. SI NO
SISTEMA DE REGISTRO
ORGANIZACIONES + IDENTIFICADORES
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/tag GET Tags
del Jardín Botánico de Barcelona
Lista todas las etiquetas de la Org. NO NO
/organization/{UUID}/tag POST ID Crea y añade un
nueva etiqueta. SI NO
/organization/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO
ORGANIZACIONES + ( TAGS / MACHINE TAGS)
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/machinetag GET Machinetags Lista todas las
etiquetas máq. NO NO
/organization/{UUID}/machinetag POST ID Crea y añade un
nueva etiqueta. SI NO
/organization/{UUID}/machinetag/{ID}
DELETE Borra la etiqueta. SI NO
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/comment
GETComentarios sobre Universidad de Córdoba
Lista los comentarios sobre la organización. NO NO
/organization/{UUID}/comment
POST IDCrea y añade un nuevo comentario asociado a la organización.
SI NO
/organization/{UUID}/comment/{ID}
DELETE Borra un comentario. SI NO
SISTEMA DE REGISTRO
ORGANIZACIONES + COMENTARIOS
URL Método Respuesta Descripción Auth Paging
/organization/{UUID}/hostedDataset
GET Dataset alojados en GBIF.es
Lista todos los dataset alojados en la organización. NO SI
/organization/{UUID}/ownedDataset
GET Dataset pertenecientes a la Universidad de Oviedo
Lista todos los dataset publicados por la organización.
NO SI
/organization/{UUID}/installation
GET Instalaciones de GBIF
.es
Lista las instalaciones de la organización NO SI
/organization/deleted GET Lista todas
las organizaciones marcadas como borradas.
NO SI
/organization/nonPublishing GET Lista todas las organizaciones
que sirven 0 dataset NO SI
/organization/pending
Lista las organizaciones que están pendientes de asociac.
NO SI
SISTEMA DE REGISTRO
ORGANIZACIONES
APPLICATION PROGRAMMING INTERFACE(API)
SISTEMA DE REGISTRO - NODOS
URL Método Respuesta Descripción Auth Paging Parámetros
/node GET Lista todos los nodos del registro.
NO SI q, identifier, identifierType
/node POST UUID Crea un nuevo nodo. SI NO
/node/{UUID} GET Información del nodo de GBIF.es
Devuelve información sobre el nodo.
NO NO
/node/{UUID} PUTActualiza información del nodo.
SI NO
/node/{UUID} DELETE Borra el nodo. SI NO
/node/{UUID}/organization GET Organizacion
es asociadas a GBIF.es
Lista todas las organizaciones asoc. a el nodo.
NO SI
NODOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/node/{UUID}/contact GET Contactos
de GBIF Portugal
Lista los contactos del nodo. NO NO
/node/{UUID}/contact POST ID Crea y añade un
nuevo contacto. SI NO
/node/{UUID}/contact/{ID} PUT Actualiza el
contacto. SI NO
/node/{UUID}/contact/{ID} DELETE Borra el contacto SI NO
NODOS + CONTACTOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/node/{UUID}/endpoint GET Endpoint d
e GBIF.esLista los puntos de acceso del nodo. NO NO
/node/{UUID}/endpoint POST ID Crea y añade un nuevo punto
de acceso del nodo. SI NO
/node/{UUID}/endpoint/{ID} DELETE Borra un punto de acceso del
nodo. SI NO
NODOS + ENDPOINTS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/node/{UUID}/identifier GET Identificadores
de GBIF.esLista los identificadores del nodo. NO NO
/node/{UUID}/identifier POST ID Crea y añade un nuevo
identificador a el nodo. SI NO
/node/{UUID}/identifier/{ID} DELETE Borra un identificador
del nodo. SI NO
SISTEMA DE REGISTRO
NODOS + IDENTIFICADORES
URL Método Respuesta
Descripción Auth Paging
/node/{UUID}/tag GET Tags de GBIF.es
Lista todas las etiquetas del nodo.
NO NO
/node/{UUID}/tag POST ID Crea y añade un nueva etiqueta. SI NO
/node/{UUID}/tag/{ID}
DELETE Borra la etiqueta. SI NO
NODOS + ( TAGS / MACHINE TAGS)
URL Método Respuesta
Descripción Auth Paging
/node/{UUID}/machinetag
GET Machinetags de GBIF.es
Lista todas las etiquetas máq. NO NO
/node/{UUID}/machinetag
POST ID Crea y añade un nueva etiqueta. SI NO
/node/{UUID}/machinetag/{ID}
DELETE Borra la etiqueta. SI NO
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/node/{UUID}/comment GET Comentarios s
obre GBIF.es
Lista los comentarios sobre el nodo. NO NO
/node/{UUID}/comment POST ID
Crea y añade un nuevo comentario asociado a ese nodo.
SI NO
/node/{UUID}/comment/{ID} DELETE Borra un comentario. SI NO
SISTEMA DE REGISTRO
NODOS + COMENTARIOS
URL Método Respuesta Descripción Auth Paging
/node/pendingEndorsement GET Lista todas las organizaciones pendie
ntes de afiliación.NO SI
/node/{UUID}/pendingEndorsement GET Organizaciones
pendientes de afiliación a GBIF.es
Lista todas las organizaciones pendientes de asociación a el nodo. NO SI
/node/country GET Lista todos los países miembros de GBIF.
NO NO
/node/activeCountries GET Lista todos los países
con derecho a votos o países participantes. (ISO-CODE)
NO NO
/node/{UUID}/dataset GET Dataset en
GBIF.esLista todos los dataset por organización alojados en ese nodo. NO SI
/node/{UUID}/installation GET Instalaciones
organizaciones de GBIF.es
Lista las instalaciones de las organizaciones asociadas a un nodo. NO SI
SISTEMA DE REGISTRO
NODOS
APPLICATION PROGRAMMING INTERFACE(API)
SISTEMA DE REGISTRO - NETWORKS
URL Método Respuesta Descripción Auth Paging Parámetros
/network GET Lista todas las redes. NO SI q, identifier,
identifierType
/network POST UUID Crea una nueva red. SI NO
/network/{UUID} GET Catalogue of
LifeDevuelve información sobre la red.
NO NO
/network/{UUID} PUT
Actualiza información de la red.
SI NO
/network/{UUID} DELETE Borra la red. SI NO
NETWORKS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/contact GET Contactos de
HerpNETLista los contactos de la red. NO NO
/network/{UUID}/contact POST ID Crea y añade un
nuevo contacto. SI NO
/network/{UUID}/contact/{ID} PUT Actualiza el
contacto. SI NO
/network/{UUID}/contact/{ID} DELETE Borra el contacto SI NO
NETWORKS + CONTACTOS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/endpoint GET Dryad Lista los puntos de acceso
de la red. NO NO
/network/{UUID}/endpoint POST ID Crea y añade un nuevo
punto de acceso a la red. SI NO
/network/{UUID}/endpoint/{ID}
DELETE Borra un punto de acceso de la red. SI NO
NETWORKS + ENDPOINTS
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/identifier
GET Identificadores de
VerNet
Lista los identificadores de la red. NO NO
/network/{UUID}/identifier POST ID Crea y añade un nuevo
identificador a la red. SI NO
/network/{UUID}/identifier/{ID}
DELETE Borra un identificador de la red. SI NO
SISTEMA DE REGISTRO
NETWORKS + IDENTIFICADORES
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/tag GET Tags de Catal
ogue of Life
Lista todas las etiquetas de la red. NO NO
/network/{UUID}/tag POST ID Crea y añade un
nueva etiqueta. SI NO
/network/{UUID}/tag/{ID} DELETE Borra la etiqueta. SI NO
NETWORKS + ( TAGS / MACHINE TAGS)
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/machinetag GET Metatags
CoLLista todas las etiquetas máq. NO NO
/network/{UUID}/machinetag POST ID Crea y añade un
nueva etiqueta. SI NO
/network/{UUID}/machinetag/{ID} DELETE Borra la etiqueta. SI NO
SISTEMA DE REGISTRO
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/comment GET Comentarios
sobre KNB
Lista los comentarios sobre la red. NO NO
/network/{UUID}/comment POST ID
Crea y añade un nuevo comentario asociado a la red.
SI NO
/network/{UUID}/comment/{ID}
DELETE Borra un comentario. SI NO
SISTEMA DE REGISTRO
NETWORKS + COMENTARIOS
URL Método Respuesta Descripción Auth Paging
/network/{UUID}/constituents
GET OZCAM Lista los dataset que forman la red. NO SI
/network/{UUID}/constituents
POST ID Crea un nuevo dataset asociado a esa red. SI NO
/network/{UUID}/constituents/{ID}
DELETE Borra un dataset de esa red. SI NO
SISTEMA DE REGISTRO
NETWORKS + DATASET
APPLICATION PROGRAMMING INTERFACE(API)
INFORMACIÓN DE ESPECIES
URL Método Respuesta Descripción Auth Paging Parámetros
/species GET Species listLista todos los nombres de la checklist.
NO SI(Explicación)
language, datasetKey, sourceId, name
/species/{int} GET Acalypha
(*)
Devuelve información sobre la sp.
NO NO
/species/{int}/verbatim
GET Devuelve el verbatim . NO NO
/species/{int}/name GET Acalypha nam
eInformación del nombre. NO NO
NAME USAGE (Introducción)
INFORMACIÓN DE ESPECIES
URL Método Respuesta Descripción Auth Paging Parámetros
/species/{int}/parents GET Padres de Acaly
pha
Lista los padres en la taxonomía.
NO NO language
/species/{int}/children GET Hijos de Acalyph
aLista los hijos de Acalypha. NO SI language
/species/{int}/related GET Relacionados
con Acalypha
Lista los nombres afines de otras checklist.
NO NO language, datasetKey
/species/{int}/synomyms
GET Sinónimos de Orthotrichum gymnostomum
(*)
Devuelve los sinónimos del nombre.
NO NO language,
NAME USAGE
INFORMACIÓN DE ESPECIES
URL Método Respuesta Descripción Paging
/species/{int}/descriptions GET Descripciones del
Lemur cattaDescripciones sobre la especie. SI
/species/{int}/distributions GET
Distribución del Lemur catta
Lista los hijos de Acalypha. SI
/species/{int}/images GET
Imágenes del Lemur Catta
(*)
Lista los nombres afines de otras checklist.
NO
NAME USAGE
INFORMACIÓN DE ESPECIES
BÚSQUEDA DE NOMBRES
INFORMACIÓN DE ESPECIES
- Nos encontramos con 4 tipos de búsquedas las cuales se distinguen por cómo buscan la información, por el formato que devuelven y por el contenido sobre el cual realizan la búsqueda.
1. Búsqueda simple: Busca un nombres científicos a lo largo de todas las checklist.
2. Búsqueda aproximada: de nombres científicos en el GBIF Backbone Taxonomy, pudiendo especificar la taxonomía.
3. Búsqueda completa: Busca el nombre en varios campos: scientific name, vernacular name, en la descripción de la especie, en la distribución y por toda la clasificación.
4. Búsqueda autocompletada: Buscar los 20 primeros registros cuyo nombre científico coincida.
URL Método Respuesta Descripción Paging Parámetros
/species GET Puma concolor Búsqueda exacta. NO language
/species/match GET Oenante,
Plantae, verbose = true
Búsqueda aproximada. SI
rank, name, strict, verbose (1=muestra los descartados), kingdom, phylum, class, order, family, genus
BÚSQUEDA DE NOMBRES
INFORMACIÓN DE ESPECIES
URL Método Respuesta Descripción Paging Parámetros
/species/search GET Puma
rank= GenusBúsqueda completa. SI
q, datasetKey, rank, highertaxonKey, status, extinct(status bool), habitat(true=marine) nameType
/species/suggest GET
Buscar Puma con en un dataset
específico.Búsqueda simple SI q, datasetKey, rank
BÚSQUEDA DE NOMBRES
INFORMACIÓN DE ESPECIES
URL Método Respuesta Descripción Paging Parámetros
/species/parser/name GET
Análisis de Acalypha
y Lemur Catta
Analizador de nombres científicos.
NO name
PARSED NAMES
INFORMACIÓN DE ESPECIES
• Permite mostrar el análisis de varios nombres científicos.
APPLICATION PROGRAMMING INTERFACE(API)
INFORMACIÓN SOBRE OBSERVACIONES Y
ESPECÍMENES
URL Método Respuesta Descripción Auth Paging Parámetros
/occurrence/{key}
GET Registro de BC-lich
Devuelve los detalles de un registro.
NO NO language
/occurrence/{key}/verbatim
GETVerbatim del un registro de
BC-lich
Devuelve el verbatim de un registro.
NO SI language
OCCURENCES
INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES
Estas API nos proporcionan servicios para obtener información de un registro de forma individual.
NOTA: La key es el GBIF_ID que podemos observar en la ficha del registro.
URL Método Respuesta Descripción Paging Parámetros
/occurrence/search
GET
Occurrence del dataset de la Universidad de Córdoba (
Fungi-COFC)
Busca los registros a través del GBIF occurrence Storage y los ordena por relevancia.
SI
datasetKey, year, month, latitude, longitude, country, publishingCountry, altitude, depth, institutionCode, collectionCode, catalogNumber, collectorName, basisOfRecord, taxonKey, georeferenced, geometry, spatialIssues
BÚSQUEDAS
INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES
URL Método Respuesta Descripción Paging Parámetros
/occurrence/search/catalog_number
GET C.N que contengan GDA
Buscar por número de catálogo.
NO q, limit
/occurrence/search/collection_code GET Código de col
ección = SANT
Busca códigos de colección.
NO q, limit
/occurrence/search/collector_name GET Collector
names = Jacint
Busca nombres de colector.
NO q, limit
/occurrence/search/institution_code GET Instituciones
que contengan MA
Busca las instituciones.
NO q, limit
BÚSQUEDAS
INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES
URL Método Respuesta Parámetros
/occurrence/count GET Número total de registros
country (NO ISO), georeferenced,BasisOfRecord
/occurrence/count/Schema GET Listado de schemas
soportados.
/occurrence/count/basis_of_record GET Número de registros p
or Basis of Record.
/occurrence/count/year GET Cuenta de registros
por año.
ESTADÍSTICAS
INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES
URL Método Respuesta Descripción Parámetros
/occurrence/counts/ datasets GET Cuenta los registr
os de todos los datasets GBIF.ES
Contabiliza el número de registros por dataset país.
country, nubkey
/occurrence/counts/Countries GET Registros cuyo or
igen es España.
Contabiliza todos registros cuyo país de origen es el escrito.
publishingCountry
/occurrence/counts/publishingCountry GET Agrupa por país
de origen los registros de España.
Cuenta todos los registros publicados en ese país.
country
INVENTARIO
INFORMACIÓN DE ESPECIMENES Y OBSERVACIONES
APPLICATION PROGRAMMING INTERFACE(API)
MAPAS
WEB MAP TILE SERVICE: FORMATO
MAPAS
http://api.gbif.org/v0.9/map/density/tile?x={x}&y={y}&z={z}
Parámetros:⁻ type – oligatorio – TAXON, DATASET,COUNTRY,PUBLISHER⁻ key – obligatorio – taxon_key,uuid del dataset/publisher o el ISO country code.⁻ resolution – opcional (por defecto =1, {1,2,4,..,16}) Densidad⁻ layer - opcional – Nos permite definir las capas de información que queramos
que sean visualizadas.⁻ palette – opcional – Permite seleccionar el juego de colores con el cual
queremos que se coloreen las cantidades de datos mostrados.⁻ saturation & hue: Cuando saturation=true, el hue puede tomar un valor entre 0
y 1.
WEB MAP TILE SERVICE
MAPAS
Esta api nos permite visualizar contenido de GBIF en mapas interactivos.
Características soportadas:
1. Capas para country, dataset, taxon (species, subspecies o higer taxon), publisher.
2. Permite personalizar el color o definir un propio estilo en el cual se muestras los datos.
3. Permite filtrar los contenidos mostrados por Basis of Record. Ej: Specimens, Observations, Fossils etc.
4. Dependiendo del tipo de Basis of record se puede especificar el periodo por décadas. Ej: Un mapa que nos muestre todas las observaciones de una especie desde 1970.
NOTA: se puede usar con la api de googel maps, con la librería de leaflet JS o con simples mapas en JS. Estas liberías permiten la visualización de las capas de datos sobre la capa geográficas
CASOS PRÁCTICOS:
MAPAS
1. Mapa de observaciones y especímenes.http://www.gbif.es/occurrenceMap.html
2. Mapa con Filtrados.http://www.gbif.es/Map.html
APPLICATION PROGRAMMING INTERFACE(API)
ANEXO
GBIF Taxonomic Backbone (nub)
Vocabularios controlados: http://builds.gbif.org/view/Common/job/gbif-api/site/apidocs/allclasses
-noframe.html
REFERENCIAS
ANEXO