Content Negotiation

Access NOBLEID metadata in multiple formats using HTTP content negotiation.

How It Works

NOBLEID resolvers support HTTP content negotiation, allowing you to request metadata in different formats by specifying the desired media type in the Accept header. This enables seamless integration with citation managers, reference tools, and automated systems.

Basic Example

# Request BibTeX format
curl -H "Accept: application/x-bibtex" \
  https://nobleid.org/20092025/7X9K2Q

# Request CSL-JSON format  
curl -H "Accept: application/vnd.citationstyles.csl+json" \
  https://nobleid.org/20092025/7X9K2Q

Supported Formats

CSL-JSON

Citation Style Language JSON format for reference managers

.json

Media Type:

application/vnd.citationstyles.csl+json

BibTeX

LaTeX bibliography format for academic publishing

.bib

Media Type:

application/x-bibtex

RIS

Research Information Systems format for citation tools

.ris

Media Type:

application/x-research-info-systems

JSON-LD

Linked Data format with Schema.org vocabulary

.jsonld

Media Type:

application/ld+json

Dublin Core XML

Dublin Core metadata in XML format

.xml

Media Type:

application/xml

cURL Examples

BibTeX Format

curl -H "Accept: application/x-bibtex" \
  -H "User-Agent: MyApp/1.0" \
  https://nobleid.org/20092025/7X9K2Q

Returns BibTeX entry ready for LaTeX bibliography

CSL-JSON Format

curl -H "Accept: application/vnd.citationstyles.csl+json" \
  -H "User-Agent: MyApp/1.0" \
  https://nobleid.org/20092025/7X9K2Q

Returns structured JSON for citation processors like Zotero

RIS Format

curl -H "Accept: application/x-research-info-systems" \
  -H "User-Agent: MyApp/1.0" \
  https://nobleid.org/20092025/7X9K2Q

Returns RIS format for EndNote and other reference managers

JSON-LD Format

curl -H "Accept: application/ld+json" \
  -H "User-Agent: MyApp/1.0" \
  https://nobleid.org/20092025/7X9K2Q

Returns structured data with Schema.org vocabulary

Multiple Formats (Priority Order)

curl -H "Accept: application/vnd.citationstyles.csl+json;q=1.0, \
                application/x-bibtex;q=0.8, \
                application/json;q=0.5" \
  https://nobleid.org/20092025/7X9K2Q

Requests CSL-JSON first, falls back to BibTeX, then generic JSON

Response Examples

BibTeX Response

@article{smith2025climate,
  title={Climate Change Impacts on Biodiversity},
  author={Smith, John and Johnson, Alice},
  journal={Journal of Environmental Science},
  year={2025},
  publisher={Academic Press},
  doi={10.1000/182},
  url={https://nobleid.org/20092025/7X9K2Q},
  note={NOBLEID: ark:/nobleid/20092025/7X9K2Q}
}

CSL-JSON Response

{
  "type": "article-journal",
  "id": "ark:/nobleid/20092025/7X9K2Q",
  "title": "Climate Change Impacts on Biodiversity",
  "author": [
    {"family": "Smith", "given": "John"},
    {"family": "Johnson", "given": "Alice"}
  ],
  "container-title": "Journal of Environmental Science",
  "issued": {"date-parts": [[2025]]},
  "publisher": "Academic Press",
  "DOI": "10.1000/182",
  "URL": "https://nobleid.org/20092025/7X9K2Q"
}

Best Practices

Request Headers

• Always include a User-Agent header
• Use specific media types when possible
• Include quality values for fallback formats
• Respect rate limits and cache responses

Error Handling

• Handle 406 Not Acceptable responses
• Implement retry logic with backoff
• Check Content-Type in responses
• Validate received data format

View API Documentation Citation Examples

# Request BibTeX format curl -H "Accept: application/x-bibtex" \ https://nobleid.org/20092025/7X9K2Q # Request CSL-JSON format curl -H "Accept: application/vnd.citationstyles.csl+json" \ https://nobleid.org/20092025/7X9K2Q

@article{smith2025climate, title={Climate Change Impacts on Biodiversity}, author={Smith, John and Johnson, Alice}, journal={Journal of Environmental Science}, year={2025}, publisher={Academic Press}, doi={10.1000/182}, url={https://nobleid.org/20092025/7X9K2Q}, note={NOBLEID: ark:/nobleid/20092025/7X9K2Q} }

{ "type": "article-journal", "id": "ark:/nobleid/20092025/7X9K2Q", "title": "Climate Change Impacts on Biodiversity", "author": [ {"family": "Smith", "given": "John"}, {"family": "Johnson", "given": "Alice"} ], "container-title": "Journal of Environmental Science", "issued": {"date-parts": [[2025]]}, "publisher": "Academic Press", "DOI": "10.1000/182", "URL": "https://nobleid.org/20092025/7X9K2Q" }