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

# Registra uma assinatura

> Este endpoint éresponsávelpor criar uma nova assinatura para o cliente autenticado.

> Observação:  
Em ambientes de testes, por vezes a API do Gateway de pagamento pode nos retornar um status code nas faixas 400 ou 500, mesmo quando os dados solicitados estão coerentes. Recomendamos fortemente quea requisição seja reprocessada, até que retorne uma resposta positiva .

<ParamField header="Authorization" type="string" required>
  Token de autenticação do tipo Bearer obtido através do endpoint de login.
</ParamField>


## OpenAPI

````yaml POST /subscriptions
openapi: 3.0.3
info:
  title: Clubfix Webservice de Parceiros
  description: >-
    Bem vido(a) à documentação do **Webservice de Parceiros** da **Clubfix.** Os
    recursos aqui dispostos são suplementados com exemplos de respostas
    esperadas, para nortear a implementação. Caso haja algum empecilho ou erro
    não esperado, fique à vontade para chamar o suporte em TI pelos canais que
    você já conhece.


    Observação: Utilize sempre os cabeçalhos `Content-Type` e `Accept` como
    `application/json`


    #### **URL Base**


    | **Ambiente** | **URL** |

    | --- | --- |

    | Homologação | [https://homolog.clubfix.com.br/webservice]() |

    | Produção | [https://clubfix.com.br/webservice]() |


    > NOTA: Para conseguir utilizar ambos ambientes, faz-se necessário solicitar
    pelo nosso time de suporte a geração das chaves de autenticação mencionadas
    na seção de **Autenticação**. 
      

    #### Paginação


    Para navegar nos recursos de listagem através de suas páginas, utilize as
    `parâmeros` dispostas na tabela abaixo


    | **Parâmetro** | **Descrição** |

    | --- | --- |

    | page | Corresponde à pagina que você deseja exibir os dados. |

    | per_page | Altera a quantidade de itens devolvidos em uma requisição. |

    | current_page | Identifica a pagina correspondente àquela requisição. |


    ### **Conhecendo os erros comuns**


    | **Status Code** | **Descrição** |

    | --- | --- |

    | 422 | Erro em algum parâmetro fornecido. O resultado deste erro será um
    objeto, onde a sua chave indicará o campo que não está em conformidade. |

    | 401 | Não autorizado. Significa que há ausência de um token válido na
    requisição, seja por expiração, não fornecimento, ou, no caso do login, as
    suas credenciais não estão corretas. |

    | 5** | Erro de servidor no endpoint requisitado. Quando isso ocorrer,
    contate o nosso suporte. |
  version: 1.0.0
servers: []
security: []
paths:
  /subscriptions:
    post:
      summary: Criar Assinatura
      description: >-
        Este endpoint éresponsávelpor criar uma nova assinatura para o cliente
        autenticado.


        > Observação:  

        Em ambientes de testes, por vezes a API do Gateway de pagamento pode nos
        retornar um status code nas faixas 400 ou 500, mesmo quando os dados
        solicitados estão coerentes. Recomendamos fortemente quea requisição
        seja reprocessada, até que retorne uma resposta positiva .
      parameters:
        - name: Accept
          in: header
          required: true
          schema:
            type: string
          example: application/json
      responses:
        '201':
          description: Assinatura criada com sucesso
          content:
            application/json:
              example:
                id: 19
                customer:
                  id: 11
                  name: Sergio Danilo Jr.
                  document: '31815134070'
                  phone: '32863751018'
                  email: sergio8@email.com
                  address:
                    street: Beco João Veloso
                    number: 770
                    complement: null
                    zipcode: '82820320'
                    neighborhood: Bairro Alto
                    city: Curitiba
                    state: PR
                device:
                  id: 2
                  name: onetouch|5017E PIXI3 4.5 DS
                  brand:
                    id: 1
                    name: Alcatel
                    meta:
                      link: https://homolog.clubfix.com.br/webservice/brands/1
                  meta:
                    link: https://homolog.clubfix.com.br/webservice/models/2
                  serial_number: '356133319339510'
                valor: 7.75
                franchise: 93.33
                is_used: true
                status:
                  id: 18
                  assinatura_id: 19
                  status: protegido
                  created_at: '2023-07-26T12:06:30.000000Z'
                  updated_at: '2023-07-26T12:06:30.000000Z'
                created_at: '2023-07-26 09:06:30'

````