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

# Integrations

> To integrate with any endpoint in Codenull you will need a token to authenticate. First you must generate an API KEY from the application.

### Getting an authentication token

To integrate with any endpoint in Codenull you will need a token to authenticate. First you must to generate an API\_KEY from the application.\
\
Go to `Designer > Integrations > API Keys`

<figure>
  <img src="https://mintcdn.com/codenull/9RtgKoAtzvpYtN-c/images/b2QNN4yqNIEEISrcB6uB.png?fit=max&auto=format&n=9RtgKoAtzvpYtN-c&q=85&s=7fc5fa26781e7c939f3bbec6782cd3ee" alt="" width="1220" height="552" data-path="images/b2QNN4yqNIEEISrcB6uB.png" />

  <figcaption />
</figure>

From this section you can generate one or more API keys for the application. Each generated API key returns:

* `clientId`: unique identifier for this integration.
* `apiKey`: secret value used to request an authentication token.

The `apiKey` is shown only once when it is generated. Store it securely. Codenull only stores a hash of the API key and it cannot be retrieved later.

You can generate multiple API keys for the same application, for example one per external integration. You can also delete an API key to revoke access for that integration.

To request a token, call:

```json theme={null}
//request params
{
  "url": "https://MY_APPLICATION_DOMAIN/api/auth/token",
  "method": "POST",
  "body": {
    "clientId": "YOUR_GENERATED_CLIENT_ID",
    "apiKey": "YOUR_GENERATED_API_KEY"
  }
}

// response
{
    "access_token": "xxxxxxxxxxxxxxx", //token to be used.
    "expires_in": 86400, //time in seconds
    "token_type": "Bearer"
}
```

<Warning>
  Since API version \`2.10.0\`, \`/api/auth/token\` no longer accepts Auth0
  \`client\_id\` and \`client\_secret\` from external clients. Integrations must
  use the \`clientId\` and \`apiKey\` generated from the application Designer.
</Warning>

### Consuming a Codenull enpoint

<Tabs>
  <Tab title="Node.JS (axios)">
    ```javascript theme={null}
    var axios = require('axios');
    var data = JSON.stringify({
      "operationName": "updateProducto",
      "variables": {
        "Id": "9999",
        "data": {
          "CalcularImpuestos": false,
          "CategoriaId": "2",
          "Codigo": "B- Frutal Mango 500ML",
          "Costo": 2000,
          "DescuentoEmpleadoAplicable": false,
          "Facturable": true,
          "MostrarEnInventario": true,
          "Id": "24",
          "Nombre": "FRUTAL MANGO 500ML",
          "PosClientId": "0d3ZGanGSO6NxXgx",
          "Precio": 3000,
          "SincronizacionFacturaId": "927",
          "Sincronizado": true,
          "SumarImpuestosAlPrecio": false,
          "GastoFijo": false,
          "Combos__ProductoPadreId": []
        }
      },
      "query": "mutation updateProducto($Id: ID!, $data: ProductoInput) {\n  updateProducto(Id: $Id, data: $data)\n}"
    });

    var config = {
    method: 'post',
    url: 'https://MY_APPLICATION_DOMAIN/graphql',
    headers: {
    'authorization': 'Bearer TOKEN_RECEIVED_ABOVE_xxxxxxx',  
     'content-type': 'application/json',
    'x-userid': '4' //pass this user id in case you need to associate the operation to a specific user
    },
    data : data
    };

    axios(config)
    .then(function (response) {
    console.log(JSON.stringify(response.data));
    })
    .catch(function (error) {
    console.log(error);
    });

    ```
  </Tab>

  <Tab title="CURL">
    ```shell theme={null}
    curl --location --request POST 'https://MY_APPLICATION_DOMAIN/graphql' \
    --header 'authorization: Bearer TOKEN_RECEIVED_ABOVE_xxxxxxxxxx' \
    --header 'content-type: application/json' \
    --header 'x-userid: 4' \
    --data-raw '{"operationName":"updateProducto","variables":{"Id":"24","data":{"CalcularImpuestos":false,"CategoriaId":"2","Codigo":"B- Frutal Mango 500ML","Costo":2000,"DescuentoEmpleadoAplicable":false,"Facturable":true,"MostrarEnInventario":true,"Id":"24","Nombre":"FRUTAL MANGO 500ML","PosClientId":"0d3ZGanGSO6NxXgx","Precio":3000,"SincronizacionFacturaId":"927","Sincronizado":true,"SumarImpuestosAlPrecio":false,"GastoFijo":false,"Combos__ProductoPadreId":[]}},"query":"mutation updateProducto($Id: ID!, $data: ProductoInput) {\n  updateProducto(Id: $Id, data: $data)\n}"}'
    ```
  </Tab>

  <Tab title="C#">
    ```csharp theme={null}
    var client = new RestClient("https://MY_APPLICATION_DOMAIN/graphql");
    client.Timeout = -1;
    var request = new RestRequest(Method.POST);
    request.AddHeader("authorization", "Bearer TOKEN_RECEIVED_ABOVE_xxxxxxx");
    request.AddHeader("content-type", "application/json");
    request.AddHeader("x-userid", "4"); //pass this is if you need an user in the server logic
    var body = @"{""operationName"":""updateProducto"",""variables"":{""Id"":""24"",""data"":{""CalcularImpuestos"":false,""CategoriaId"":""2"",""Codigo"":""B- Frutal Mango 500ML"",""Costo"":2000,""DescuentoEmpleadoAplicable"":false,""Facturable"":true,""MostrarEnInventario"":true,""Id"":""24"",""Nombre"":""FRUTAL MANGO 500ML"",""PosClientId"":""0d3ZGanGSO6NxXgx"",""Precio"":3000,""SincronizacionFacturaId"":""927"",""Sincronizado"":true,""SumarImpuestosAlPrecio"":false,""GastoFijo"":false,""Combos__ProductoPadreId"":[]}},""query"":""mutation updateProducto($Id: ID!, $data: ProductoInput) {\n  updateProducto(Id: $Id, data: $data)\n}""}";
    request.AddParameter("application/json", body,  ParameterType.RequestBody);
    IRestResponse response = client.Execute(request);
    Console.WriteLine(response.Content);
    ```
  </Tab>
</Tabs>

### Consuming from a browser

If you are planning to consume any endpoint from a browser (Client-side) you will need to configure the CORS and allow from which domain you are consuming the API

To allow a domain to consume any Codenull API endpint you must add it on Application Settings section