aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2019-11-12 18:57:13 -0800
committerBryan Newbold <bnewbold@robocracy.org>2020-01-03 15:53:41 -0800
commit6c95f23bfbef73f231ca94309031a130f12f2c32 (patch)
tree700d8d7c02e515bcdf2a1e0436a20438aa253a81
parent7f7b45dc54757d9d451be0b3816f8f8481143c7f (diff)
downloadfatcat-6c95f23bfbef73f231ca94309031a130f12f2c32.tar.gz
fatcat-6c95f23bfbef73f231ca94309031a130f12f2c32.zip
fatcat identifiers proposal (WIP)
-rw-r--r--proposals/20190514_fatcat_identifiers.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/proposals/20190514_fatcat_identifiers.md b/proposals/20190514_fatcat_identifiers.md
new file mode 100644
index 00000000..941775e3
--- /dev/null
+++ b/proposals/20190514_fatcat_identifiers.md
@@ -0,0 +1,25 @@
+
+Fatcat Identifiers
+=======================
+
+AKA, `fcid`
+
+## Public Use / Reference
+
+When referencing identifiers in external databases, should prefix with the
+entity type. Eg:
+
+ release_hsmo6p4smrganpb3fndaj2lon4
+ editgroup_qinmjr2lbvgd3mbt7mifir23fy
+
+Or with a prefix:
+
+ fatcat:release_hsmo6p4smrganpb3fndaj2lon4
+
+As a usability affordance, the public web interface (though not API) should do
+permanent redirects HTTP (301 or 308) to the canonical page like:
+
+ https://fatcat.wiki/release_hsmo6p4smrganpb3fndaj2lon4
+ HTTP 301 => https://fatcat.wiki/release/hsmo6p4smrganpb3fndaj2lon4
+
+However, no intention to use identifiers in this schema in the API itself?