{"openapi":"3.0.3","info":{"title":"Al-Shaheed Al-Samad Digital City — Digital Library Partner API","version":"1.2.0","description":"Institutional Partner REST API & Metadata Exchange (SRS-DL-2026-01 FR-A-01..06). Exposes published public bibliographic records in Dublin Core & ISO-8601 formats. Restricted/Secret items and user PII are strictly excluded."},"servers":[{"url":"/api/v1","description":"Digital Library API Gateway v1.2"}],"paths":{"/items":{"get":{"summary":"Search & harvest public Dublin Core bibliographic records","security":[{"PartnerApiKey":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Normalized Arabic/English search query"},{"name":"domain","in":"query","schema":{"type":"string"},"description":"Research domain filter"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"JSON array of public Dublin Core bibliographic items"},"401":{"description":"Missing or invalid x-api-key header"},"429":{"description":"Daily institution quota exceeded (includes Retry-After header)"}}}},"/items/{id}":{"get":{"summary":"Fetch a single public Dublin Core record by item ID or Handle","security":[{"PartnerApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Item ID (e.g. 11037) or Handle"}],"responses":{"200":{"description":"Public Dublin Core bibliographic record"},"401":{"description":"Missing or invalid x-api-key header"},"404":{"description":"Public record not found"},"429":{"description":"Daily institution quota exceeded"}}}}},"components":{"securitySchemes":{"PartnerApiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}}}