> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engineapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Cadastro pelo site cria a conta na hora (JOT-3540)

> 
**Porta de entrada da EngineAPI.** Cria na hora, na MESMA transação: o
**pedido de acesso** já APPROVED, o **Partner** no **plano Dev (R$ 0)** e um
**convite de dono** por e-mail — a senha é escolhida no aceite do convite,
nunca aqui. O Telegram do JP vira aviso informativo ("conta criada").

Limites contra abuso (rota pública, identidade = IP):

* **5 pedidos por minuto por IP** (throttle, 429 acima disso);
* **N contas por IP a cada 24 h** (`LIMITE_CONTAS_POR_IP_24H`, padrão 3;
  em homologação, 1000). Acima do limite, 429 citando o valor em vigor;
* e-mail já usado por usuário ou parceiro devolve o MESMO 202, sem criar
  nada (não revela quais e-mails existem);
* e-mail de domínio descartável recusa com 422 (`EMAIL_DESCARTAVEL`).
    



## OpenAPI

````yaml /openapi.json post /v1/auth/register
openapi: 3.1.0
info:
  title: EngineAPI - Motor Fiscal SaaS
  description: >-

    ## API de Emissão Fiscal B2B2B


    EngineAPI é uma plataforma SaaS para emissão de documentos fiscais
    eletrônicos brasileiros.


    ### Documentos Suportados

    - **NF-e** (Modelo 55) - Nota Fiscal Eletrônica

    - **NFC-e** (Modelo 65) - Nota Fiscal de Consumidor Eletrônica

    - **NFS-e** - Nota Fiscal de Serviços Eletrônica


    > CTe (57) e MDFe (58): roadmap sem data, fora da superfície pública.


    ### Autenticação

    Todas as rotas protegidas requerem:

    ```

    Authorization: Bearer <seu_token>    # JWT (painel web)

    x-api-key: ek_live_<sua_key>         # API Key (server-to-server)

    ```


    ### Rate Limits

    - **Por plano** (janela de 1 segundo): Dev 5 · Starter 20 · Growth 60 ·
    Scale 200 req/s

    - Headers `X-RateLimit-Limit`/`Remaining`/`Reset` em toda resposta;
    `Retry-After` no 429


    ### Idempotency

    POSTs aceitam header `Idempotency-Key` para prevenir duplicatas:

    ```

    Idempotency-Key: <uuid-único-por-operação>

    ```


    ### Ambientes

    - **Homologação**: Para testes (SEFAZ sandbox)

    - **Produção**: Emissões reais


    ### Suporte

    - Email: suporte@engineapi.com.br

    - Docs: https://docs.engineapi.com.br
        
  version: unknown
  contact:
    name: engineAPI
    url: https://engineapi.com.br
    email: suporte@engineapi.com.br
  license:
    name: Proprietário
    url: https://engineapi.com.br/legal/termos
servers:
  - url: https://api.engineapi.com.br
    description: Produção
security: []
tags:
  - name: Cérebro Fiscal
    description: >-
      Classificação fiscal assistida + tributação IBS/CBS (tier 80%, apoio à
      decisão)
  - name: Autenticação
    description: Login, registro de conta e API Keys
  - name: Empresas
    description: Gestão de empresas emitentes (Issuers)
  - name: NFe
    description: Nota Fiscal Eletrônica (Modelo 55)
  - name: NFCe
    description: Nota Fiscal de Consumidor (Modelo 65)
  - name: NFSe
    description: Nota Fiscal de Serviços Eletrônica
  - name: Consultas
    description: Consulta de CNPJ e CPF
  - name: Webhooks
    description: Configuração, entregas e reenvio de eventos assíncronos
  - name: Status
    description: Status público por serviço e canário de deploy
  - name: Saúde
    description: Liveness/readiness do processo e sanidade de autenticação
paths:
  /v1/auth/register:
    post:
      tags:
        - Autenticação
      summary: Cadastro pelo site cria a conta na hora (JOT-3540)
      description: >-

        **Porta de entrada da EngineAPI.** Cria na hora, na MESMA transação: o

        **pedido de acesso** já APPROVED, o **Partner** no **plano Dev (R$ 0)**
        e um

        **convite de dono** por e-mail — a senha é escolhida no aceite do
        convite,

        nunca aqui. O Telegram do JP vira aviso informativo ("conta criada").


        Limites contra abuso (rota pública, identidade = IP):


        * **5 pedidos por minuto por IP** (throttle, 429 acima disso);

        * **N contas por IP a cada 24 h** (`LIMITE_CONTAS_POR_IP_24H`, padrão 3;
          em homologação, 1000). Acima do limite, 429 citando o valor em vigor;
        * e-mail já usado por usuário ou parceiro devolve o MESMO 202, sem criar
          nada (não revela quais e-mails existem);
        * e-mail de domínio descartável recusa com 422 (`EMAIL_DESCARTAVEL`).
            
      operationId: register
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccessRequestDto'
      responses:
        '202':
          description: >-
            Conta criada (ou e-mail já em uso — resposta idêntica, sem criar
            nada)
          content:
            application/json:
              schema:
                example:
                  message: Conta criada. Enviamos o convite para o seu e-mail.
        '400':
          description: >-
            Payload inválido (email malformado, nomes < 2 chars, WhatsApp
            inválido)
        '422':
          description: E-mail de domínio descartável (código EMAIL_DESCARTAVEL)
        '429':
          description: >-
            Rate limit excedido (5 pedidos/min por IP, ou
            LIMITE_CONTAS_POR_IP_24H contas/24h por IP, padrão 3)
components:
  schemas:
    AccessRequestDto:
      type: object
      properties:
        name:
          type: string
          minLength: 2
          maxLength: 120
        companyName:
          type: string
          minLength: 2
          maxLength: 120
        whatsapp:
          type: string
          minLength: 8
          maxLength: 20
        email:
          type: string
          maxLength: 254
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
        emits:
          type: string
          minLength: 1
          maxLength: 200
        volumePerMonth:
          type: string
          maxLength: 50
        erpStack:
          type: string
          maxLength: 200
      required:
        - name
        - companyName
        - whatsapp
        - email
        - emits

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.