Repository navigation
docs(content): document reciter_id, beta and audio file duration - #255
Conversation
quran.com-api #1029 (deployed to production) adds:
- /resources/chapter_reciters: reciter_id and beta
- /chapter_recitations/{reciter_id} and /{chapter_number}: duration (ms)
Regenerate the three affected API pages. The 403 text in those pages
also changes because they had not been regenerated since the spec's
403 description was updated.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits. |
Deploying qf-api-docs with
|
| Latest commit: |
b77d400
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://75e7b7f4.qf-api-docs.pages.dev |
| Branch Preview URL: | https://docs-v4-reciter-id-beta-dura.qf-api-docs.pages.dev |
|
@codex review |
|
Codex Review: Didn't find any major issues. Keep it up! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
Why
quran/quran.com-api#1029 added three fields to Content API v4 that partners moving off
/qdcwere missing. It is deployed to production. I verified the fields there with cache-busted requests: all three match/qdcfor every production reciter and audio file I compared.Changes
openAPI/content/v4.json:chapter-recitersschema:id: clarified that this is the chapter-reciter ID used by/chapter_recitations/{reciter_id}.reciter_id(integer, nullable): the person reciting. Several chapter reciters can share one.beta(boolean).chapter-recitationandAudioFileschemas: newduration(integer, milliseconds, nullable).4withreciter_id3, and file457hasduration53000.Generated pages: regenerated only the three affected operations (
chapter-reciters,chapter-reciter-audio-files,chapter-reciter-audio-file) in bothdocs/content_apis_versioned/and4.0.0/. Their 403 text also changes, because these pages were stale against the spec's current 403 description.contract:openapi:checkpasses.🤖 Generated with Claude Code