Api Keys

Las API keys son utilizadas para autenticar las solicitudes en fiscalapi. Cada API key tiene un conjunto de roles y/o permisos asociados que determinan qué acciones puede realizar el usuario que la posee. Fiscalapi le permite gestionar las API keys de su organización de forma programática.

Modelo API Key

El modelo de API Key es un modelo de datos que representa una clave de autenticación en fiscalapi.

Propiedades

Name
id
Type
string?
Description
Identificador único de la API key asignado por Fiscalapi.
Name
environment
Type
string?
Description
El entorno al que pertenece la API key.
Name
apiKeyValue
Type
string?
Description
El API key. Este valor es el que se utiliza para autenticar las solicitudes.
Name
personId
Type
string?
Description
El identificador único de la persona a la que pertenece la API key.
Name
tenantId
Type
string?
Description
El identificador único del tenant al que pertenece la API key.
Name
apiKeyStatus
Type
string?
Description
El estado de la API key.
Type
enum:
Values
01
Name
description
Type
string?
Description
Nombre o description de la API key.

GET/api/v4/apikeys

Listar api-keys

Este endpoint te permite recuperar una lista paginada de todas las api-keys de su organización. De forma predeterminada, se muestran diez apikeys por página, pero puedes ajustar esto con los parámetros de consulta.

Query parameters

Name
pageNumber
Type
int
required
Description
El número de página que se desea recuperar.
Default:
1
Name
pageSize
Type
int
required
Description
Valor entre 1 y 50 inclusivo para indicar la cantidad de registros devueltos por página.
Default:
10

Request

GET

/api/v4/apikeys?pageNumber=1&pageSize=2

curl --location 'https://test.fiscalapi.com/api/v4/apikeys?pageNumber=1&pageSize=2' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <api_key>' \
--data ''

Response

{
    "data": {
        "items": [
            {
                "environment": "Test",
                "apiKeyValue": "sk_test_...",
                "personId": "5fd9f48c-a6a2-474f-944b-88a01751d432",
                "tenantId": "102e5f13-e114-41dd-bea7-507fce177281",
                "apiKeyStatus": 0,
                "description": null,
                "id": "539d247f-6624-4086-86fc-170715af9fbd",
                "createdAt": "2025-01-07T15:24:22.1446925",
                "updatedAt": "2025-01-07T15:24:45.7387097"
            },
            {
                "environment": "Test",
                "apiKeyValue": "sk_test_...",
                "personId": "78d380fd-1b69-4e3c-8bc0-4f57737f7d5f",
                "tenantId": "102e5f13-e114-41dd-bea7-507fce177281",
                "apiKeyStatus": 1,
                "description": null,
                "id": "99553e5f-7562-40e7-8b0b-7eb3548b77f0",
                "createdAt": "2025-01-07T15:28:37.5030339",
                "updatedAt": "2025-01-07T15:28:37.5030361"
            }
        ],
        "pageNumber": 1,
        "totalPages": 3,
        "totalCount": 6,
        "hasPreviousPage": false,
        "hasNextPage": true
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

POST/api/v4/apikeys

Crear Api-Key

Este endpoint te permite crear una nueva api-key para un usuario (persona) de su organización.

Modelo

Name
personId
Type
string?
Description
Id de la persona a la que se le asignará la api-key.
Name
description
Type
string??
Description
Nombre o descripción de la API key.

Request

POST

/api/v4/apikeys

curl --location 'https://test.fiscalapi.com/api/v4/apikeys' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api_key>' \
--data '{
  "personId" : "<person_id>",
  "description" : "api-key para cliente ABC"
}'

Response

{
    "data": {
        "environment": "Test",
        "apiKeyValue": "sk_test_...",
        "personId": "5fd9f48c-a6a2-474f-944b-88a01751d432",
        "tenantId": "102e5f13-e114-41dd-bea7-507fce177281",
        "apiKeyStatus": 1,
        "description": "api-key para cliente ABC",
        "id": "6c757df8-9f22-42b9-890d-3ae08c143355",
        "createdAt": "2025-05-01T08:32:15.2863188",
        "updatedAt": "2025-05-01T08:32:15.2863194"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

GET/api/v4/apikeys/<id>

Obtener Api-Key por ID

Este endpoint te permite obtener una api-key por su id.

Request

GET

/api/v4/apikeys/<id>

curl --location 'https://test.fiscalapi.com/api/v4/apikeys/99553e5f-7562-40e7-8b0b-7eb3548b77f0' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <api_key>' \
--data ''

Response

{
    "data": {
        "environment": "Test",
        "apiKeyValue": "sk_test_...",
        "personId": "78d380fd-1b69-4e3c-8bc0-4f57737f7d5f",
        "tenantId": "102e5f13-e114-41dd-bea7-507fce177281",
        "apiKeyStatus": 1,
        "description": "api-key del cliente ABC",
        "id": "0153a9b8-f219-46ba-a7b5-f4ec92bdfa26",
        "createdAt": "2025-01-07T15:28:37.5030339",
        "updatedAt": "2025-01-07T15:28:37.5030361"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

PUT/api/v4/apikeys/<id>

Actualizar Api-Key

Este endpoint te permite actualizar una api-key de un usuario (persona) de su organización.

Modelo

Name
id
Type
string?
Description
Id de la api-key a actualizar.
Name
description
Type
string?
Description
Nombre o description de la API key.
Name
apiKeyStatus
Type
string?
Description
El estado de la API key.
Type
enum:
Values
01

Request

PUT

/api/v4/apikeys/<id>

curl --location --request PUT 'https://test.fiscalapi.com/api/v4/apikeys/<id>' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api_key>' \
--data '{
  "id": "6c757df8-9f22-42b9-890d-3ae08c143355",
  "description": "Api-key server 001...",
  "apiKeyStatus": 0
}'

Response

{
    "data": {
        "environment": "Test",
        "apiKeyValue": "sk_test...",
        "personId": "5fd9f48c-a6a2-474f-944b-88a01751d432",
        "tenantId": "102e5f13-e114-41dd-bea7-507fce177281",
        "apiKeyStatus": 0,
        "description": "Api-key server 001",
        "id": "6c757df8-9f22-42b9-890d-3ae08c143355",
        "createdAt": "2025-05-01T08:32:15.2863188",
        "updatedAt": "2025-05-01T08:33:09.0203389"
    },
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}

DELETE/api/v4/apikeys/<id>

Eliminar Api-Key

Este endpoint te permite eliminar una api-key de un usuario (persona) de su organización.

Request

DELETE

/api/v4/apikeys/<id>

curl --location --request DELETE 'https://test.fiscalapi.com/api/v4/apikeys/<id>' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'X-API-KEY: <api_key>' \
--data ''

Response

{
    "data": true,
    "succeeded": true,
    "message": "",
    "details": "",
    "httpStatusCode": 200
}