full diff

pub.chive.claiming.getSuggestions

lexicons.governance.chive.pub +0 −0

← Back to Compare Lexicon page

From

bafyreihbf2wcctaqvu6kmnyaobolpiw5n7e5axr6brpgyh5m6af5fsszom indexed 2026-06-18 13:14 UTC View this version

Compatibility

backward compatible No changes detected.

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

44 "externalAuthor": {

55 "properties": {

66 "affiliation": {

77 "description": "Institution affiliation",

88 "type": "string"

99 },

1010 "email": {

1111 "description": "Email address",

1212 "type": "string"

1313 },

1414 "name": {

1515 "description": "Author name",

1616 "type": "string"

1717 },

1818 "orcid": {

1919 "description": "ORCID identifier",

2020 "type": "string"

2121 }

2222 },

2323 "required": [

2424 "name"

2525 ],

2626 "type": "object"

2727 },

2828 "main": {

2929 "description": "Get suggested papers for the authenticated user to claim based on their profile",

3030 "errors": [

3131 {

3232 "name": "AuthenticationRequired"

3333 }

3434 ],

3535 "output": {

3636 "encoding": "application/json",

3737 "schema": {

3838 "properties": {

3939 "papers": {

4040 "description": "Suggested papers sorted by match score",

4141 "items": {

4242 "ref": "#suggestedPaper",

4343 "type": "ref"

4444 },

4545 "type": "array"

4646 },

4747 "profileUsed": {

4848 "ref": "#profileMetadata",

4949 "type": "ref"

5050 }

5151 },

5252 "required": [

5353 "papers",

5454 "profileUsed"

5555 ],

5656 "type": "object"

5757 }

5858 },

5959 "parameters": {

6060 "properties": {

6161 "limit": {

6262 "default": 20,

6363 "description": "Maximum number of suggestions to return",

6464 "maximum": 50,

6565 "minimum": 1,

6666 "type": "integer"

6767 }

6868 },

6969 "type": "params"

7070 },

7171 "type": "query"

7272 },

7373 "profileMetadata": {

7474 "description": "Profile data used for matching",

7575 "properties": {

7676 "displayName": {

7777 "description": "User display name",

7878 "type": "string"

7979 },

8080 "hasExternalIds": {

8181 "description": "Whether user has external authority IDs",

8282 "type": "boolean"

8383 },

8484 "hasOrcid": {

8585 "description": "Whether user has ORCID linked",

8686 "type": "boolean"

8787 },

8888 "nameVariants": {

8989 "description": "Name variants used for matching",

9090 "items": {

9191 "type": "string"

9292 },

9393 "type": "array"

9494 }

9595 },

9696 "required": [

9797 "nameVariants",

9898 "hasOrcid",

9999 "hasExternalIds"

100100 ],

101101 "type": "object"

102102 },

103103 "suggestedPaper": {

104104 "properties": {

105105 "abstract": {

106106 "description": "Abstract text",

107107 "type": "string"

108108 },

109109 "authors": {

110110 "description": "Author list",

111111 "items": {

112112 "ref": "#externalAuthor",

113113 "type": "ref"

114114 },

115115 "type": "array"

116116 },

117117 "categories": {

118118 "description": "Subject categories",

119119 "items": {

120120 "type": "string"

121121 },

122122 "type": "array"

123123 },

124124 "chiveUri": {

125125 "description": "AT-URI of the paper in Chive's index (present when source is 'chive')",

126126 "type": "string"

127127 },

128128 "doi": {

129129 "description": "DOI if assigned",

130130 "type": "string"

131131 },

132132 "externalId": {

133133 "description": "Source-specific identifier",

134134 "type": "string"

135135 },

136136 "matchReason": {

137137 "description": "Human-readable match reason",

138138 "type": "string"

139139 },

140140 "matchScore": {

141141 "description": "Match confidence score (0-100)",

142142 "maximum": 100,

143143 "minimum": 0,

144144 "type": "integer"

145145 },

146146 "pdfUrl": {

147147 "description": "URL to PDF",

148148 "format": "uri",

149149 "type": "string"

150150 },

151151 "publicationDate": {

152152 "description": "Publication date",

153153 "format": "datetime",

154154 "type": "string"

155155 },

156156 "source": {

157157 "description": "Source system",

158158 "type": "string"

159159 },

160160 "title": {

161161 "description": "Eprint title",

162162 "type": "string"

163163 },

164164 "url": {

165165 "description": "Full URL to the eprint",

166166 "format": "uri",

167167 "type": "string"

168168 }

169169 },

170170 "required": [

171171 "externalId",

172172 "url",

173173 "title",

174174 "authors",

175175 "source",

176176 "matchScore",

177177 "matchReason"

178178 ],

179179 "type": "object"

180180 }

181181 },

182182 "id": "pub.chive.claiming.getSuggestions",

183183 "lexicon": 1,

184184 "revision": 1

185185}