Hyperlink management system
ID converter system
[English]

Webサービスについて

リンク自動管理システム、ID一括変換システムの機能をブラウザ以外のアプリケーションで利用して頂くために、
webサービスを公開しました。現在、RESTによるAPIを公開しています。

Webサービスの利用方法

APIはIDの変換・URLの取得を行う"convert"、統計情報等を取得する"entry"に大別できます。
[ ]の要素はオプションです。 サンプルAPI
http://biodb.jp/convert/id_type/id_type or db_type/entry_id[,entry_id2,...][format]/
						[output][count][format]/[offset,limit][format]
	

http://biodb.jp/entry/method[format]/[count][format]
	

  • APIで使用できる要素一覧
  • 要素指定する文字列概要
    id_type,db_type下記リスト参照 
    entry_idex(AB210043)id_typeに該当するデータIDを指定する。(100 IDまで指定可能)
    outputidID対応表を返す
    urlリンクの対応表を返す
    format.txt結果をテキスト形式で返す
    .json結果をjson形式で返す
    countcount結果の件数を返す
    offset,limit0以上の整数 例(5,10)結果の件数を指定する。例では5件目から14件目を取得できる。(limitの上限は100)
    methodid_type登録しているデータIDのリストを返す
    db_type登録しているデータベースのリストを返す
    update登録しているデータベースの更新情報を返す
    url各データIDからデータベースへのリンク情報を返す

    レスポンスはtext形式かjson形式で取得できます。
    不正な文字列が送信された場合はHTTPコード404を返します。
    entry_idに対応するデータがない場合、json形式では["err":"Not Found"]、テキスト形式ではNot Foundを返します。


  • 使用できるid_typeとdb_typeの一覧
  • id_typeデータIDの種類
    acc_idAccession Number
    hit_idH-Inv transcript ID (HIT)
    hix_idH-Inv cluster ID (HIX)
    hip_idH-Inv protein ID (HIP)
    uniprot_idUniProt Accession Number
    gene_symbolHUGO gene symbol
    ref_seqRefSeq
    omim_idOMIM ID
    gene_idGeneID
    pubmed_idPubMed ID
    ms_idH-GOLD Marker ID
    pdb_idPDB ID
    fr_idfRNAdb ID
    enst_idEnsembl Transcript ID
    ensg_idEnsembl Gene ID
    clone_idClone ID (NBRC)
    flj_idFLJ ID (NBRC)
    kegg_idKEGG Gene ID
    pathway_idKEGG Pathway ID
    hprd_idHPRD ID
    protein_idRefSeq Protein ID
    cipro_idCIPRO ID
    cco_pdbechem_idPdbeChem ID
    cco_drugbank_idDrugBank ID
    dgv_idDGV ID
    peptide_idPeptide Accession
    ensp_idEnsembl Protein ID
    db_typeデータベース名
    transcriptviewH-InvDB Transcript view
    locusviewH-InvDB Locus view
    gintegraH-InvDB G-integra
    ppiH-InvDB PPI view
    nucleotideNCBI Sequence Viewer
    genbankGenBank
    entrezgeneEntrez Gene
    omimOMIM
    pubmedPubMed
    hugoHUGO HGNC
    mutationviewMutationView
    hgoldH-GOLD
    pdbjPDBj
    uniprotUniProt
    ggdbGGDB
    frnadbfRNAdb
    enstEnsembl Transcript
    ensgEnsembl Gene
    nbrcNBRC
    hgpdHGPD
    keggKEGG
    pathwayKEGG Pathway
    hprdHPRD
    legendaLEGENDA
    evolaEVOLA
    hdbasHDBAS
    gcompassGCOMPASS
    proteinviewPROTEINVIEW
    ciproCIPRO
    hangelHANGEL
    fljhFLJH
    varysysdbVARYSYSDB
    pdbechemPDBECHEM
    drugbank_hDRUGBANK_H
    wikipedia_hpWIKIPEDIA_HP
    proteinPROTEIN
    dgvDGV
    coxpresCOXPRES
    atlasHuman Protein ATLAS
    peptidePeptide Atlas
    enspEnsembl Protein

  • APIのサンプル
  • 概要API
    Accession Number AB210043からH-InvDB Locusviewへのリンク情報(json)http://biodb.jp/convert/acc_id/locusview/AB210043
    Accession Number AB210043からH-InvDB Locusviewへのリンク情報(txt)http://biodb.jp/convert/uniprot_id/hit_id/O43278,P56555/id.txt
    UniProt Accession Number O43278,P56555とH-Inv Transcript ID (HIT)の対応表(txt)http://biodb.jp/convert/uniprot_id/transcriptview/O43278,P56555/url.txt
    UniProt Accession Number O43278,P56555とH-InvDB Transcript ViewのURL対応表(txt)http://biodb.jp/convert/uniprot_id/transcriptview/O43278,P56555/url/1,1.txt
    登録しているデータベース一覧(txt)http://biodb.jp/entry/db_type.txt
    登録しているデータID一覧(txt)http://biodb.jp/entry/id_type.txt
    データベースの更新情報(txt)http://biodb.jp/entry/update.txt
    データIDのリンク情報(txt)http://biodb.jp/entry/url.txt

    サンプルコード

    perl、java、ruby、pythonで本APIを使用する場合のサンプルコードを紹介します。
    いずれも下記の結果が返ってきます。

    レスポンス
    {hfs:{"query":{"id_type":"acc_id","id":"AB058780"},"result":{"id_type":"hit_id","id":["HIT000001592"]}}}
    


    perl 5.8.0
    #!/usr/bin/perl
    
    use LWP::UserAgent;
    
    ## set URL 
    my $url = "http://biodb.jp/convert/acc_id/hit_id/AB058780";        
    my $ua = LWP::UserAgent->new();
    my $res = $ua->get($url);
    my $json = $res->content;
    
    ## view
    print "$json\n";
    

    java 1.6.0
    import java.io.BufferedReader;
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.net.HttpURLConnection;
    import java.net.URL;
    
    public class Sample {
    
    	public static void main(String[] args) throws IOException{	
    		//set URL
    		URL url = new URL("http://biodb.jp/convert/acc_id/locusview/AB210043");
    		HttpURLConnection con = (HttpURLConnection)url.openConnection();
    		con.setRequestMethod("GET");
    		con.connect();
    		
    		BufferedReader reader =
    			new BufferedReader(new InputStreamReader(con.getInputStream()));	
    		//view
    		String line;
    		while ((line = reader.readLine())!= null){
    			System.out.println(line);
    		}	
    		reader.close();
    		con.disconnect();
    	}
    }
    

    ruby 1.6.8
    #!/usr/bin/ruby
    
    require 'net/http'
    
    Net::HTTP.version_1_2
    
    ##set host
    host='biodb.jp'
    
    ##set URL
    path='/convert/acc_id/locusview/AB210043'
    
    Net::HTTP.start(host, 80) {|http|
    response = http.get(path)
    
    ##view
    puts response.body
    }
    

    python 2.2.3
    #!/usr/bin/python
    
    import httplib
    
    ##set host
    host = "biodb.jp"
    
    ##set URL
    path = "/convert/acc_id/locusview/AB210043"
    
    con = httplib.HTTPConnection(host)
    con.request('GET', path, body='')
    response = con.getresponse()
    
    ##view
    print response.read()