Dbfetch URL Syntax

Contents

Dbfetch

Entry Retrieval

The general format of the dbfetch URL is:

dbfetch?db={db}&format={format}&style={style}&id={id}&pageHtml={pageHtml}

Where the parameters are:

Name Description Default value
db Database name. See databases for available values. default (currently ENA Sequence)
format Data format for entries. Available values depend on the database. default
style Result style for entries. Either html or raw. default
id Entry identifiers. A comma or space separated list of entry identifiers. Required.  
pageHtml Include HTML page header and footer for html result style requests. To disable to header and footer set to false true

For example:

If omitted the db, format and style parameters use default values:

For the default database (ENA Sequence) an abbreviated syntax can be used:

Alternative Endpoints

To support old links and applications a series of alternative endpoints are provided which have appropriate defaults:

Meta-information

Details of the databases, formats and styles available in dbfetch in a range of formats:

The following information is provided for each of the available databases:

WSDbfetch (REST)

Entries can also be retrieved using RESTful URLs, of the form:

dbfetch/{db}/{id}/{format}?style={style}

Where the parameters are:

Name Description Default value
db Database name. See databases for available values. default (currently ENA Sequence). Required.
id Entry identifiers. A comma or space separated list of entry identifiers. Required.  
format Data format for entries. Available values depend on the database. default
style Result style for entries. Either html or raw. raw

If omitted the format and style parameters use default values.

For example:

See the WSDbfetch (REST) documentation for more details.

Open Biological Database Access

The Open Biological Database Access (OBDA) specifications provide standardised interfaces for accessing sequence data resources. The biofetch and Registry specifications are implemented by dbfetch.

OBDA biofetch

The OBDA biofetch specification describes the behaviour of a generic database entry retrival system.

For details see:

Dbfetch provides a partial implementation of the OBDA biofetch specification. In addition to dbfetch the biofetch specification has also been implemented elsewhere:

In addition to the data access methods detailed above the BioRuby biofetch implementation defines additional methods to access meta-information describing the available databases and formats. Dbfetch has been extended to also support these methods:

The biofetch specification defines a set of error messages:

The BioRuby biofetch implementation adds another error message for use in meta-information responses:

Dbfetch also uses some additional error messages, which are of the same form as the biofetch messages:

OBDA Registry

OBDA registry defintion for databases available through dbfetch: seqdatabase.ini

Support for using the OBDA registry to access databases is available in:

EMBOSS

The EMBOSS suite can use dbfetch as a data source, see Sequence Databases and Data Resources in the EMBOSS documentation. To simplify the use of dbfetch with EMBOSS the following sample configurations are available:

These configurations are derived from the dbfetch configration and are automatically updated as databases and formats are added to or removed from dbfetch.

Note: with EMBOSS 6.4.0 (Release Notes) support for database servers has been added to EMBOSS (see servertell and showserver) and the USA syntax extended to provide query access to named database servers (see Data Resources). This includes support for both the dbfetch and WSDbfetch (SOAP) services at EMBL-EBI.