SOLAV Journal provides a fully compliant Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) 2.0 repository to facilitate automated metadata exchange with institutional repositories, library catalogs, academic indexing services, and research discovery platforms.
Academic Purpose
This service supports the scholarly community by enabling seamless integration of SOLAV Journal's metadata into academic infrastructure systems, enhancing research visibility, and promoting open science principles through standardized interoperability.
Base URL & Protocol Access
Service Endpoint
Primary OAI-PMH Base URL
https://solav.me/oai
Access Method
HTTP GET Requests
All OAI-PMH requests are made via standard HTTP GET with query parameters:
GET /oai?verb=Identify&metadataPrefix=oai_dc
Response Format
All responses are returned as well-formed XML conforming to OAI-PMH 2.0 schema:
Content-Type: text/xml; charset=utf-8
Rate Limiting Policy
To ensure equitable access, harvesters should implement polite harvesting practices: maximum 1 request per second, with appropriate user-agent identification in HTTP headers. Aggressive harvesting may result in temporary access restrictions.
Protocol Implementation
Supported OAI-PMH Verbs
SOLAV Journal implements all six mandatory OAI-PMH verbs as specified in the protocol version 2.0:
Identify
Retrieve repository identification information, policies, and administrative details.
ListMetadataFormats
List metadata formats supported by the repository for specific items.
ListSets
Retrieve the set structure of the repository for selective harvesting.
ListIdentifiers
Retrieve identifiers of records matching specified criteria without full metadata.
ListRecords
Harvest complete records with metadata matching specified criteria.
GetRecord
Retrieve a single record with its metadata using a unique identifier.
Granularity and Datestamps
Datestamp Granularity
YYYY-MM-DD (daily granularity). All datestamps reflect UTC timezone.
Deleted Records Policy
no - SOLAV Journal does not delete published records; all metadata remains permanently available.
Metadata Formats
SOLAV Journal provides metadata in standardized formats to ensure interoperability with academic systems worldwide:
oai_dc (Dublin Core)
The primary metadata format, implementing the Dublin Core Metadata Element Set, Version 1.1 as specified in the OAI-PMH protocol.
Schema Information:
| Metadata Prefix | oai_dc |
|---|---|
| XML Schema | http://www.openarchives.org/OAI/2.0/oai_dc.xsd |
| Namespace | http://www.openarchives.org/OAI/2.0/oai_dc/ |
| Dublin Core Elements Used | 15 mandatory and optional elements as per DCMES |
Dublin Core Mapping:
- dc:title Mandatory
- dc:creator Mandatory
- dc:subject Optional
- dc:description Mandatory
- dc:publisher Mandatory
- dc:date Mandatory
- dc:type Mandatory
- dc:identifier Mandatory
- dc:language Mandatory
- dc:rights Mandatory
Future Metadata Formats
SOLAV Journal is committed to expanding metadata support. Planned future formats include MODS (Metadata Object Description Schema) and JATS (Journal Article Tag Suite) for enhanced bibliographic description.
Record Scope and Content
Included Publication Types
The OAI-PMH repository includes metadata for all scholarly content published by SOLAV Journal:
Research Articles
Original empirical and theoretical research with full methodological detail.
Review Articles
Comprehensive syntheses of existing literature within specific domains.
Editorials
Journal announcements, policy statements, and introductory commentaries.
Metadata Record Structure
Each OAI-PMH record includes:
- Header: Unique identifier, datestamp, and set membership
- Metadata: Dublin Core descriptive elements
- Identifier Scheme:
oai:solav.me:[article_id] - Persistent URLs: Links to abstract and full-text PDF
- Rights Statement: CC BY 4.0 license declaration
Temporal Coverage
The repository contains metadata for all articles published since the journal's inception (February 2025). Records are available immediately upon publication under our continuous publication model.
Harvesting Guidelines
Recommended Harvesting Practices
Initial Harvest
For first-time harvesting, use incremental approach with datestamp ranges:
?verb=ListRecords&metadataPrefix=oai_dc&from=2025-02-01
Incremental Updates
For regular updates, use datestamp of last successful harvest:
?verb=ListRecords&metadataPrefix=oai_dc&from=2025-06-01
Set Structure for Selective Harvesting
SOLAV Journal implements hierarchical set structure for content organization:
| Set Specification | Set Name | Description |
|---|---|---|
year:2025 |
2025 Publications | All articles published in calendar year 2025 |
type:research |
Research Articles | Original research contributions |
type:editorial |
Editorials | Journal announcements and commentary |
language:en |
English Language | Articles published in English |
language:ar |
Arabic Language | Articles published in Arabic |
Technical Recommendations
- Implement exponential backoff for error handling
- Set appropriate HTTP timeout values (minimum 30 seconds)
- Validate XML against OAI-PMH schema during processing
- Include informative User-Agent header with contact information
- Respect
503 Retry-Afterheaders if provided
Usage Examples
Example Requests and Responses
Request:
GET /oai?verb=Identify
Response (simplified):
<?xml version="1.0" encoding="UTF-8"?> <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/"> <responseDate>2025-06-15T10:30:00Z</responseDate> <request verb="Identify">https://solav.me/oai</request> <Identify> <repositoryName>SOLAV Journal</repositoryName> <baseURL>https://solav.me/oai</baseURL> <protocolVersion>2.0</protocolVersion> <adminEmail>[email protected]</adminEmail> <earliestDatestamp>2025-02-02</earliestDatestamp> <deletedRecord>no</deletedRecord> <granularity>YYYY-MM-DD</granularity> </Identify> </OAI-PMH>
Request:
GET /oai?verb=ListRecords&metadataPrefix=oai_dc&from=2025-05-01
Response snippet:
<?xml version="1.0" encoding="UTF-8"?> <OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/"> <responseDate>2025-06-15T10:30:00Z</responseDate> <request verb="ListRecords" metadataPrefix="oai_dc" from="2025-05-01"> https://solav.me/oai </request> <ListRecords> <record> <header> <identifier>oai:solav.me:s2025781107</identifier> <datestamp>2025-06-06</datestamp> <setSpec>year:2025</setSpec> <setSpec>type:research</setSpec> </header> <metadata> <oai_dc:dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/"> <dc:title>Continuous Publication in Online Scholarly Journals...</dc:title> <dc:creator>Khalil, Rizq</dc:creator> <dc:subject>Continuous Publication</dc:subject> <dc:description>The digital paradigm in scholarly publishing...</dc:description> <dc:date>2025-06-06</dc:date> <dc:type>Research Article</dc:type> <dc:identifier>https://solav.me/a/s2025781107</dc:identifier> <dc:identifier>https://solav.me/p/s2025781107.pdf</dc:identifier> <dc:language>en</dc:language> <dc:publisher>SOLAV Journal</dc:publisher> <dc:rights>Creative Commons Attribution 4.0 International License</dc:rights> </oai_dc:dc> </metadata> </record> </ListRecords> </OAI-PMH>
Request:
GET /oai?verb=GetRecord&identifier=oai:solav.me:s2025781101&metadataPrefix=oai_dc
Compliance & Standards
Protocol Compliance
SOLAV Journal's OAI-PMH implementation fully complies with:
OAI-PMH 2.0
Full implementation of all mandatory verbs and features
Dublin Core
DCMI Metadata Terms 1.1 implementation
OpenURL
ContextObject implementation for linking
Persistent Identifiers
OAI Identifier Format
oai:solav.me:[article_id]
Example: oai:solav.me:s2025781101
Additional Identifiers
Each record includes persistent URLs for abstract and PDF, with embedded metadata for Open Graph and Schema.org compatibility.
Validation and Testing
The OAI-PMH endpoint has been validated with the OAI-PMH Validator and tested with major harvesting tools including DSpace, OAI Harvester 2, and custom harvesting scripts. Regular compliance checks are performed to ensure ongoing protocol adherence.
Technical Contact
For questions about metadata harvesting, technical integration, or protocol implementation, please contact our technical team:
Ready to Harvest Our Metadata?
Begin integrating SOLAV Journal's scholarly metadata into your repository, discovery system, or research platform today.
Test the Endpoint Protocol Specification
