Docs
Solicitar acceso

Canjea el código por una sesión (paso 2)

POST/api/v1/auth/login/verify

Deja la cookie facturoa_session (panel) y devuelve token (frs_…) para usarlo como Authorization: Bearer frs_… en cualquier ruta, igual que una API key. Vence en 30 días.

Cuerpo de la petición application/json

  • challenge_idstring · uuidobligatorio
  • codestringobligatorio

    Ejemplo: 482913

Respuestas

200Sesión creada
  • tokenstring

    Ejemplo: frs_2Jx9…

  • expires_atstring · date-time
  • userobject
    + Ver 5 campos− Ocultar 5 campos
    • idstring · uuid
    • emailstring · email
    • namestring
    • email_verifiedboolean
    • created_atstring · date-time
  • accountobject
    + Ver 10 campos− Ocultar 10 campos
    • idstring · uuid
    • parent_account_idstring · uuid

      Casa de software dueña; igual a id si no tiene padre

    • kindstring

      Valores: independent · software_house

    • emailstring
    • document_typestring

      13 cédula o 31 NIT

      Valores: 13 · 31

    • nitstring
    • dvstring
    • namestring
    • environmentstring

      Valores: staging · habilitacion · production

    • created_atstring · date-time
401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring