{"openapi":"3.1.0","info":{"title":"Ede Yoruba Corpus API","version":"0.4.0"},"paths":{"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/stats":{"get":{"summary":"Stats","operationId":"stats_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/search":{"get":{"summary":"Search","operationId":"search_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["all","word","phrase"],"type":"string","default":"all","title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/browse":{"get":{"summary":"Browse","operationId":"browse_browse_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"enum":["all","word","phrase"],"type":"string","default":"word","title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dictionary/headwords":{"get":{"summary":"Dictionary Index","operationId":"dictionary_index_dictionary_headwords_get","parameters":[{"name":"prefix","in":"query","required":false,"schema":{"type":"string","maxLength":100,"default":"","title":"Prefix"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dictionary/word":{"get":{"summary":"Dictionary Word","operationId":"dictionary_word_dictionary_word_get","parameters":[{"name":"headword","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Headword"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dictionary/coverage":{"get":{"summary":"Dictionary Coverage","operationId":"dictionary_coverage_dictionary_coverage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/search-suggestions":{"get":{"summary":"Suggestions","operationId":"suggestions_search_suggestions_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":100,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/word-sense":{"get":{"summary":"Word Sense","operationId":"word_sense_word_sense_get","parameters":[{"name":"word","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Word"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/translate":{"get":{"summary":"Translate","operationId":"translate_translate_get","parameters":[{"name":"word","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Word"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/contribute":{"post":{"summary":"Contribute","operationId":"contribute_contribute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Contribution"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/contributions":{"get":{"summary":"Queue","operationId":"queue_review_contributions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/contributions/{ident}":{"post":{"summary":"Review","operationId":"review_review_contributions__ident__post","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Review"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/senses":{"get":{"summary":"Source Queue","operationId":"source_queue_review_senses_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":500,"default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"enum":["source_imported","needs_correction","editor_reviewed"],"type":"string","default":"source_imported","title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/senses/{ident}":{"post":{"summary":"Source Review","operationId":"source_review_review_senses__ident__post","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Review"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/summary":{"get":{"summary":"Review Summary","operationId":"review_summary_review_summary_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/history":{"get":{"summary":"Review History","operationId":"review_history_review_history_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/synonyms":{"get":{"summary":"Synonym Queue","operationId":"synonym_queue_review_synonyms_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":500,"default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"enum":["pending","approved","rejected"],"type":"string","default":"pending","title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Propose Synonym","operationId":"propose_synonym_review_synonyms_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynonymProposal"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/review/synonyms/{ident}":{"post":{"summary":"Review Synonym","operationId":"review_synonym_review_synonyms__ident__post","parameters":[{"name":"ident","in":"path","required":true,"schema":{"type":"string","title":"Ident"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Review"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Contribution":{"properties":{"word":{"type":"string","maxLength":500,"minLength":1,"title":"Word"},"translation":{"type":"string","maxLength":1000,"minLength":1,"title":"Translation"},"language":{"type":"string","const":"Yoruba","title":"Language","default":"Yoruba"},"username":{"type":"string","maxLength":80,"title":"Username","default":"Anonymous"},"dialect":{"type":"string","maxLength":100,"title":"Dialect","default":"unspecified"},"context":{"type":"string","maxLength":1000,"title":"Context","default":""},"source":{"type":"string","maxLength":500,"title":"Source","default":""},"consent":{"type":"boolean","const":true,"title":"Consent"}},"additionalProperties":false,"type":"object","required":["word","translation","consent"],"title":"Contribution"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Review":{"properties":{"approve":{"type":"boolean","title":"Approve"},"note":{"type":"string","maxLength":1000,"title":"Note","default":""}},"additionalProperties":false,"type":"object","required":["approve"],"title":"Review"},"SynonymProposal":{"properties":{"sense_id":{"type":"string","maxLength":100,"minLength":1,"title":"Sense Id"},"target":{"type":"string","maxLength":150,"minLength":1,"title":"Target"},"source":{"type":"string","maxLength":500,"minLength":1,"title":"Source"},"note":{"type":"string","maxLength":1000,"title":"Note","default":""}},"additionalProperties":false,"type":"object","required":["sense_id","target","source"],"title":"SynonymProposal"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}