API Utilisateur

Récupérer le profil et les informations de compte de l'utilisateur authentifié.

L'API Utilisateur fournit l'accès au profil et aux détails du compte de l'utilisateur authentifié.

Tous les corps de réponse utilisent des noms de champs en snake_case.

Endpoints

GET/api/v1/user

Obtenir le profil

GET/api/v1/user

Renvoie le profil et les informations de compte de l'utilisateur actuellement authentifié.

Champs de réponse

idstring

Identifiant unique de l'utilisateur

emailstring

Adresse e-mail de l'utilisateur

first_namestring or null

Prénom de l'utilisateur

last_namestring or null

Nom de l'utilisateur

language_preferencestring

Code de langue préféré (par défaut : "en")

created_atstring

Horodatage ISO 8601 de création du compte

updated_atstring

Horodatage ISO 8601 de dernière mise à jour

plan_tierstring

Current plan: "entrepreneur", "pro", or "business"

subscription_statusstring or null

Stripe subscription status (e.g., "active", "past_due", "canceled")

current_period_endstring or null

ISO 8601 end date for the current billing period

storage_used_bytesinteger

Total file storage consumed in bytes

subdomainstring or null

Custom subdomain (e.g., "acme" for acme.nueform.io). Pro plan and above.

custom_domainstring or null

Custom domain (e.g., "forms.acme.com"). Pro plan and above.

custom_domain_verified_atstring or null

ISO 8601 timestamp when the custom domain was verified. null if pending.

Réponse

json

{
  "id": "665a0a1b2c3d4e5f6a7b8c9d",
  "email": "alice@example.com",
  "first_name": "Alice",
  "last_name": "Johnson",
  "language_preference": "en",
  "created_at": "2025-11-01T10:00:00.000Z",
  "updated_at": "2026-02-28T08:15:00.000Z",
  "plan_tier": "pro",
  "subscription_status": "active",
  "current_period_end": "2026-03-15T00:00:00.000Z",
  "storage_used_bytes": 52428800,
  "subdomain": "acme",
  "custom_domain": "forms.acme.com",
  "custom_domain_verified_at": "2026-01-20T14:30:00.000Z"
}

Exemples de code

bash

curl -X GET "https://api.nueform.io/api/v1/user" \
  -H "Authorization: Bearer YOUR_API_KEY"

Réponses d'erreur

Réponses d'erreur standard renvoyées par ce point d'accès.

Codes d'erreur

401Unauthorized

Clé API manquante ou invalide

404Not Found

Utilisateur introuvable

500Server Error

Erreur interne du serveur

Exemple d'erreur

json

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "status": 401
  }
}

Dernière mise à jour : 6 avril 2026