Skip to content

Commit 7ef29da

Browse files
Sporiffkeunes
andauthored
Apply suggestions from code review
Co-authored-by: Keunes <11229646+keunes@users.noreply.github.com>
1 parent 69a44a4 commit 7ef29da

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

src/content/docs/specs/subscriptions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The `subscriptions` endpoint is designed to give clients a simple interface for
2626

2727
## 2. Motivation
2828

29-
The Podcast 2.0 specification presents developers with stable identifiers (`podcast:guid`), which are UUIDv5 values that can be calculated from the feed URL using a standard-supplied namespace. However, the original podcast specification makes no such guarantees. This makes implementing cross-device synchronization difficult, as developers need to use unstable fields to determine which feed is being targeted.
29+
The Podcasting 2.0 specification presents developers with stable identifiers (`podcast:guid`), which are UUIDv5 values that can be calculated from the feed URL using a standard-supplied namespace. However, the original podcast specification makes no such guarantees. This makes implementing cross-device synchronization difficult, as developers need to use unstable fields to determine which feed is being targeted.
3030

3131
To resolve this, the Open Podcast API makes use of the same deterministic UUID resolution outlined in the Podcast Index documentation[^1] and requires Clients to provide a calculated UUID value with every feed.
3232

@@ -610,7 +610,7 @@ curl -X GET "https://opa-server.test/api/v1/subscriptions?page_size=50"
610610
}
611611
```
612612

613-
[^1]: https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/tags/guid.md
613+
[^1]: https://podcasting2.org/docs/podcast-namespace/tags/guid
614614
[^2]: https://www.rfc-editor.org/rfc/rfc2119
615615
[^3]: https://www.rfc-editor.org/rfc/rfc3339
616616
[^4]: https://www.rfc-editor.org/rfc/rfc9562

0 commit comments

Comments
 (0)