Filaments

Resolve a raw RFID or NFC tag read to one of the current user's spools.

Send the tag's UID and, when the reader could dump it, its memory. A UID the user has linked answers linked with the spool, and refreshes what the app stored from the tag. Any other tag answers unknown: the decoded reading (null for a blank or unrecognized tag), the closest catalogMatch, and the user's own materials that fit it as suggestions. A hint of hold-still means the read was incomplete and worth repeating. Unrecognized dumps are kept for 90 days, without any account data, so new formats can be added.

post/api/Filaments/tag-reads

Request

  • Base URL: https://api.3dprintlog.com
  • URL: https://api.3dprintlog.com/api/Filaments/tag-reads
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://3dprintlog.auth0.com/authorize, token URL https://3dprintlog.auth0.com/oauth/token)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Request body

uidstring nullable
techsstring[] nullable

Response

The tag resolved to a spool, or to a reading with suggestions.

statusstring nullable

"linked" when the user's spool carries the tag, otherwise "unknown".

hintstring nullable

"hold-still" when the read was incomplete and worth repeating, otherwise null.

Changes

No recorded changes to this operation across all 1 revision of this API.