Skip to content

API de UserData

La API de UserData aceptará los siguientes valores para el campo user_data_type.

StringValor numéricoDescripción
USER_DATA_TYPE_PFP1Foto de perfil del usuario
USER_DATA_TYPE_DISPLAY2Nombre para mostrar del usuario
USER_DATA_TYPE_BIO3Biografía del usuario
USER_DATA_TYPE_URL5URL del usuario
USER_DATA_TYPE_USERNAME6Nombre preferido del usuario
USER_DATA_TYPE_LOCATION7Ubicación del usuario
USER_DATA_TYPE_TWITTER8Nombre de usuario de Twitter
USER_DATA_TYPE_GITHUB9Nombre de usuario de GitHub

Consulta FIP-196 para más información sobre Ubicación. Consulta FIP-19 para más información sobre nombres de usuario de Twitter/X y Github.

userDataByFid

Obtener UserData para un FID.

Parámetros de consulta

ParámetroDescripciónEjemplo
fidEl FID solicitadofid=6833
user_data_typeEl tipo de datos de usuario, ya sea como valor numérico o cadena de tipo. Si se omite, se devuelven todos los datos de usuario para el FIDuser_data_type=1 O user_data_type=USER_DATA_TYPE_DISPLAY

Ejemplo

bash
curl http://127.0.0.1:2281/v1/userDataByFid?fid=6833&user_data_type=1

Respuesta

json
{
  "data": {
    "type": "MESSAGE_TYPE_USER_DATA_ADD",
    "fid": 6833,
    "timestamp": 83433831,
    "network": "FARCASTER_NETWORK_MAINNET",
    "userDataBody": {
      "type": "USER_DATA_TYPE_PFP",
      "value": "https://i.imgur.com/HG54Hq6.png"
    }
  },
  "hash": "0x327b8f47218c369ae01cc453cc23efc79f10181f",
  "hashScheme": "HASH_SCHEME_BLAKE3",
  "signature": "XITQZD7q...LdAlJ9Cg==",
  "signatureScheme": "SIGNATURE_SCHEME_ED25519",
  "signer": "0x0852...6e999cdd"
}