diff options
| author | hodlbod <jstaab@protonmail.com> | 2024-09-25 15:15:46 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-09-25 15:15:46 -0700 |
| commit | 4438b892d8abd189afc75f9f54532ec95f108d9f (patch) | |
| tree | c138d3cce59f39bcee864bf79d57d60eeffc0c7b | |
| parent | 4e73e94d417f16fa3451e58ef921cb3b512c6f8e (diff) | |
| parent | 79786bb7bbb32162c233d99850cb33b379c2fc7a (diff) | |
Merge pull request #1508 from MerryOscar/expand-external-content-ids
NIP-73 - Expand External Content IDs
| -rw-r--r-- | 73.md | 24 |
1 files changed, 18 insertions, 6 deletions
| @@ -6,17 +6,29 @@ External Content IDs | |||
| 6 | 6 | ||
| 7 | `draft` `optional` | 7 | `draft` `optional` |
| 8 | 8 | ||
| 9 | There are certain established global content identifiers that would be useful to reference in nostr events so that clients can query all events assosiated with these ids. | 9 | There are certain established global content identifiers such as [Book ISBNs](https://en.wikipedia.org/wiki/ISBN), [Podcast GUIDs](https://podcastnamespace.org/tag/guid), and [Movie ISANs](https://en.wikipedia.org/wiki/International_Standard_Audiovisual_Number) that are useful to reference in nostr events so that clients can query all the events assosiated with these ids. |
| 10 | 10 | ||
| 11 | - Book [ISBNs](https://en.wikipedia.org/wiki/ISBN) | ||
| 12 | - Podcast [GUIDs](https://podcastnamespace.org/tag/guid) | ||
| 13 | - Movie [ISANs](https://en.wikipedia.org/wiki/International_Standard_Audiovisual_Number) | ||
| 14 | |||
| 15 | Since the `i` tag is already used for similar references in kind-0 metadata events it makes sense to use it for these content ids as well. | ||
| 16 | 11 | ||
| 12 | `i` tags are used for referencing these external content ids, with `k` tags representing the external content id kind so that clients can query all the events for a specific kind. | ||
| 17 | 13 | ||
| 18 | ## Supported IDs | 14 | ## Supported IDs |
| 19 | 15 | ||
| 16 | | Type | `i` tag | `k` tag | | ||
| 17 | |- | - | - | | ||
| 18 | | URLs | "`<URL, normalized, no fragment>`" | "`<scheme-host, normalized>`" | | ||
| 19 | | Hashtags | "#`<topic, lowercase>`" | "#" | | ||
| 20 | | Geohashes| "geo:`<geohash, lowercase>`" | "geo" | | ||
| 21 | | Books | "isbn:`<id, without hyphens>`" | "isbn" | | ||
| 22 | | Podcast Feeds | "podcast:guid:`<guid>`" | "podcast:guid" | | ||
| 23 | | Podcast Episodes | "podcast:item:guid:`<guid>`" | "podcast:item:guid" | | ||
| 24 | | Podcast Publishers | "podcast:publisher:guid:`<guid>`" | "podcast:publisher:guid" | | ||
| 25 | | Movies | "isan:`<id, without version part>`" | "isan" | | ||
| 26 | | Papers | "doi:`<id, lowercase>`" | "doi" | | ||
| 27 | |||
| 28 | --- | ||
| 29 | |||
| 30 | ## Examples | ||
| 31 | |||
| 20 | ### Books: | 32 | ### Books: |
| 21 | 33 | ||
| 22 | - Book ISBN: `["i", "isbn:9780765382030"]` - https://isbnsearch.org/isbn/9780765382030 | 34 | - Book ISBN: `["i", "isbn:9780765382030"]` - https://isbnsearch.org/isbn/9780765382030 |