Empezar

La API sigue el estilo REST sobre HTTPS e intercambia JSON. Cada llamada se autentica con una API key que creas desde la web, en Mi cuenta › API Keys y que se envía en la cabecera Authorization. La llamada más sencilla devuelve los datos de tu cuenta:

curl -H "Authorization: Bearer tp_…" \
  https://api.tutiplay.com/v1/me

{
  "id": "99af283f-9a91-47ec-9f94-0656e7704b27",
  "username": "tu_usuario",
  "email": "tu@correo.com",
  "firstName": "…",
  "lastName": "…",
  "description": null,
  "photoUrl": null,
  "dateJoined": "2026-09-01T10:00:00Z"
}

Una key empieza por tp_ y solo se muestra una vez, al crearla: Tutiplay almacena su hash, no su valor, por lo que no es posible recuperarla. Si se pierde, hay que revocarla y crear otra. Puede tener fecha de caducidad o no tenerla, y una cuenta puede tener varias activas a la vez. Se recomienda usar una por cliente, de modo que cada una pueda revocarse sin afectar a las demás.