API REST

API REST fiel al código.

URL base: https://api.aifoxapp.com/api/v1

Autenticación

Usa un token Bearer JWT o una clave de API donde se indique.

Ejemplo JWT

Authorization: Bearer $AIFOX_TOKEN

Ejemplo clave de API

X-API-Key: $AIFOX_API_KEY

Auth

POST/auth/register

Crea un usuario y su organización.

URL completa: https://api.aifoxapp.com/api/v1/auth/register
Acceso: Público
Entradas: email, password, full_name?, org_name?, terms_accepted
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/auth/register' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/auth/login

Devuelve un token de acceso Bearer.

URL completa: https://api.aifoxapp.com/api/v1/auth/login
Acceso: Público
Entradas: application/x-www-form-urlencoded: username, password
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/auth/login' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/auth/me

Devuelve el usuario actual.

URL completa: https://api.aifoxapp.com/api/v1/auth/me
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/auth/me' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/auth/org

Devuelve la organización actual.

URL completa: https://api.aifoxapp.com/api/v1/auth/org
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/auth/org' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Apps

GET/apps/

Lista o crea los apps de la organización.

URL completa: https://api.aifoxapp.com/api/v1/apps/
Acceso: JWT o clave de API
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/apps/' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/apps/

Lista o crea los apps de la organización.

URL completa: https://api.aifoxapp.com/api/v1/apps/
Acceso: JWT o clave de API
Entradas: name, package_name, platform=both, min_native_version?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/apps/' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/apps/{app_id}

Consulta, actualiza o elimina un app.

URL completa: https://api.aifoxapp.com/api/v1/apps/{app_id}
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/apps/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

PUT/apps/{app_id}

Consulta, actualiza o elimina un app.

URL completa: https://api.aifoxapp.com/api/v1/apps/{app_id}
Acceso: JWT o clave de API
Entradas: app_id; name?, min_native_version?, icon_url?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X PUT 'https://api.aifoxapp.com/api/v1/apps/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

DELETE/apps/{app_id}

Consulta, actualiza o elimina un app.

URL completa: https://api.aifoxapp.com/api/v1/apps/{app_id}
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X DELETE 'https://api.aifoxapp.com/api/v1/apps/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Bundles

GET/bundles/app/{app_id}

Lista bundles OTA activos del app.

URL completa: https://api.aifoxapp.com/api/v1/bundles/app/{app_id}
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/bundles/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/bundles/app/{app_id}/upload

Sube y valida un bundle ZIP.

URL completa: https://api.aifoxapp.com/api/v1/bundles/app/{app_id}/upload
Acceso: JWT o clave de API
Entradas: multipart: version, file (.zip, máx 200 MB)
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/bundles/app/{app_id}/upload' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -F 'version=1.0.0' -F 'file=@bundle.zip'

GET/bundles/{bundle_id}

Consulta o marca un bundle como eliminado.

URL completa: https://api.aifoxapp.com/api/v1/bundles/{bundle_id}
Acceso: JWT o clave de API
Entradas: bundle_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/bundles/{bundle_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

DELETE/bundles/{bundle_id}

Consulta o marca un bundle como eliminado.

URL completa: https://api.aifoxapp.com/api/v1/bundles/{bundle_id}
Acceso: JWT o clave de API
Entradas: bundle_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X DELETE 'https://api.aifoxapp.com/api/v1/bundles/{bundle_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Channels

GET/channels/app/{app_id}

Lista o crea canales de distribución.

URL completa: https://api.aifoxapp.com/api/v1/channels/app/{app_id}
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/channels/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/channels/app/{app_id}

Lista o crea canales de distribución.

URL completa: https://api.aifoxapp.com/api/v1/channels/app/{app_id}
Acceso: JWT
Entradas: app_id; name, slug, public=false, ios=true, android=true
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/channels/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/channels/{channel_id}

Consulta, actualiza o elimina un canal.

URL completa: https://api.aifoxapp.com/api/v1/channels/{channel_id}
Acceso: JWT
Entradas: channel_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/channels/{channel_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

PUT/channels/{channel_id}

Consulta, actualiza o elimina un canal.

URL completa: https://api.aifoxapp.com/api/v1/channels/{channel_id}
Acceso: JWT
Entradas: channel_id; name?, current_bundle_id?, secondary_bundle_id?, public?, rollout_percentage? (0–100)
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X PUT 'https://api.aifoxapp.com/api/v1/channels/{channel_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

DELETE/channels/{channel_id}

Consulta, actualiza o elimina un canal.

URL completa: https://api.aifoxapp.com/api/v1/channels/{channel_id}
Acceso: JWT
Entradas: channel_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X DELETE 'https://api.aifoxapp.com/api/v1/channels/{channel_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/channels/{channel_id}/promote/{bundle_id}

Promueve un bundle y preserva la versión anterior.

URL completa: https://api.aifoxapp.com/api/v1/channels/{channel_id}/promote/{bundle_id}
Acceso: JWT
Entradas: channel_id, bundle_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/channels/{channel_id}/promote/{bundle_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/channels/{channel_id}/rollback

Intercambia el bundle actual por el bundle anterior.

URL completa: https://api.aifoxapp.com/api/v1/channels/{channel_id}/rollback
Acceso: JWT
Entradas: channel_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/channels/{channel_id}/rollback' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Devices

GET/devices/app/{app_id}

Lista dispositivos del app.

URL completa: https://api.aifoxapp.com/api/v1/devices/app/{app_id}
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/devices/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/devices/app/{app_id}/register

Registra o actualiza un dispositivo.

URL completa: https://api.aifoxapp.com/api/v1/devices/app/{app_id}/register
Acceso: JWT
Entradas: app_id; device_id, platform=android, push_token?, push_provider?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/devices/app/{app_id}/register' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/devices/{device_id}/channel

Asocia el dispositivo a un canal.

URL completa: https://api.aifoxapp.com/api/v1/devices/{device_id}/channel
Acceso: JWT
Entradas: device_id, channel_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/devices/{device_id}/channel' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Updates

POST/updates/check

Verifica si hay una actualización OTA para el cliente del app.

URL completa: https://api.aifoxapp.com/api/v1/updates/check
Acceso: Cliente del app
Entradas: device_id, app_id, version, platform, os_version?, plugin_version?, channel?, custom_id?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/updates/check' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/updates/downloaded

Registra la descarga de un bundle.

URL completa: https://api.aifoxapp.com/api/v1/updates/downloaded
Acceso: Cliente del app
Entradas: query: device_id, bundle_version, app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/updates/downloaded' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/updates/installed

Registra la instalación de un bundle.

URL completa: https://api.aifoxapp.com/api/v1/updates/installed
Acceso: Cliente del app
Entradas: query: device_id, bundle_version, app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/updates/installed' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/updates/failed

Registra una falla de actualización.

URL completa: https://api.aifoxapp.com/api/v1/updates/failed
Acceso: Cliente del app
Entradas: query: device_id, bundle_version, app_id, error?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/updates/failed' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/updates/bundle/{app_id}/{version}.zip

Descarga un bundle por URL firmada y no expirada.

URL completa: https://api.aifoxapp.com/api/v1/updates/bundle/{app_id}/{version}.zip
Acceso: URL firmada
Entradas: app_id, version; query: exp, sig
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/updates/bundle/{app_id}/{version}.zip' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Manifests

GET/manifests/app/{app_id}

Lista o crea versiones inmutables de manifiesto.

URL completa: https://api.aifoxapp.com/api/v1/manifests/app/{app_id}
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/manifests/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/manifests/app/{app_id}

Lista o crea versiones inmutables de manifiesto.

URL completa: https://api.aifoxapp.com/api/v1/manifests/app/{app_id}
Acceso: JWT o clave de API
Entradas: app_id; chassis=chassi1, data (requiere app_name y primary_color)
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/manifests/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Modules

GET/module-runtime/registry/v2

Lista schemas, fases y requisitos mínimos de módulos.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/registry/v2
Acceso: Público
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/module-runtime/registry/v2' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/module-runtime/public/{package_name}/config

Devuelve la configuración pública desinfectada de módulos.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/public/{package_name}/config
Acceso: Público
Entradas: package_name
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/module-runtime/public/{package_name}/config' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/module-runtime/custom-modules/v1

Lista extensiones declarativas curadas con hash de integridad.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/custom-modules/v1
Acceso: Público
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/module-runtime/custom-modules/v1' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/module-runtime/app/{app_id}/config

Consulta o actualiza la configuración administrativa de módulos.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/config
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/config' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

PUT/module-runtime/app/{app_id}/config

Consulta o actualiza la configuración administrativa de módulos.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/config
Acceso: JWT
Entradas: app_id; modules[]
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X PUT 'https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/config' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/module-runtime/app/{app_id}/publish

Publica la siguiente versión del manifiesto.

URL completa: https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/publish
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/module-runtime/app/{app_id}/publish' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Content

GET/content/public/{package_name}/rss

Devuelve un feed RSS o Atom validado y normalizado.

URL completa: https://api.aifoxapp.com/api/v1/content/public/{package_name}/rss
Acceso: Público
Entradas: package_name
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/content/public/{package_name}/rss' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Commerce

GET/commerce/app/{app_id}/integrations

Devuelve el estado desinfectado de conectores.

URL completa: https://api.aifoxapp.com/api/v1/commerce/app/{app_id}/integrations
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/commerce/app/{app_id}/integrations' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/commerce/app/{app_id}/shopify/sync

Sincroniza un catálogo Shopify ya provisionado.

URL completa: https://api.aifoxapp.com/api/v1/commerce/app/{app_id}/shopify/sync
Acceso: JWT
Entradas: app_id; limit?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/commerce/app/{app_id}/shopify/sync' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Purchases

POST/purchases/public/{package_name}/verify

Valida una compra de tienda en el servidor para el miembro autenticado.

URL completa: https://api.aifoxapp.com/api/v1/purchases/public/{package_name}/verify
Acceso: Cliente del app
Entradas: platform, product_id, product_type, purchase_token, environment?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/purchases/public/{package_name}/verify' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/purchases/public/{package_name}/entitlements

Lista los accesos activos del miembro autenticado.

URL completa: https://api.aifoxapp.com/api/v1/purchases/public/{package_name}/entitlements
Acceso: Cliente del app
Entradas: package_name
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/purchases/public/{package_name}/entitlements' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Intelligence

POST/intelligence/public/{package_name}/assistant

Devuelve una respuesta basada en el contexto publicado del app.

URL completa: https://api.aifoxapp.com/api/v1/intelligence/public/{package_name}/assistant
Acceso: Público
Entradas: question
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/intelligence/public/{package_name}/assistant' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/intelligence/app/{app_id}/autofill

Devuelve una sugerencia administrativa sin aplicarla.

URL completa: https://api.aifoxapp.com/api/v1/intelligence/app/{app_id}/autofill
Acceso: JWT
Entradas: app_id; module_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/intelligence/app/{app_id}/autofill' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Builds

GET/builds/app/{app_id}

Lista los últimos 50 builds del app.

URL completa: https://api.aifoxapp.com/api/v1/builds/app/{app_id}
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/builds/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/builds/app/{app_id}/android

Enfileira un build Android.

URL completa: https://api.aifoxapp.com/api/v1/builds/app/{app_id}/android
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/builds/app/{app_id}/android' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

POST/builds/app/{app_id}/ios

Enfileira un build iOS con el proveedor configurado.

URL completa: https://api.aifoxapp.com/api/v1/builds/app/{app_id}/ios
Acceso: JWT o clave de API
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/builds/app/{app_id}/ios' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/builds/{build_id}

Devuelve un build.

URL completa: https://api.aifoxapp.com/api/v1/builds/{build_id}
Acceso: JWT o clave de API
Entradas: build_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/builds/{build_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Preview

POST/preview/generate

Genera una sesión de preview pública con límite de tasa.

URL completa: https://api.aifoxapp.com/api/v1/preview/generate
Acceso: Público
Entradas: business? o site_url?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/preview/generate' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/preview/{session_id}

Devuelve una sesión de preview activa.

URL completa: https://api.aifoxapp.com/api/v1/preview/{session_id}
Acceso: Público
Entradas: session_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/preview/{session_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Consultor

POST/consultor/chat

Envía un mensaje al consultor público.

URL completa: https://api.aifoxapp.com/api/v1/consultor/chat
Acceso: Público
Entradas: messages; business?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/consultor/chat' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Billing

GET/billing/plan

Devuelve el plan y su estado.

URL completa: https://api.aifoxapp.com/api/v1/billing/plan
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/billing/plan' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/billing/checkout

Crea una sesión de Checkout para suscripción.

URL completa: https://api.aifoxapp.com/api/v1/billing/checkout
Acceso: JWT
Entradas: plan: essencial | profissional | loja | enterprise
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/billing/checkout' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

GET/billing/wallet

Devuelve saldo y los últimos 20 lanzamientos.

URL completa: https://api.aifoxapp.com/api/v1/billing/wallet
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/billing/wallet' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/billing/topup

Crea un Checkout para el paquete fijo de créditos.

URL completa: https://api.aifoxapp.com/api/v1/billing/topup
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/billing/topup' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

API keys

GET/api-keys/

Lista o crea claves de API.

URL completa: https://api.aifoxapp.com/api/v1/api-keys/
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/api-keys/' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/api-keys/

Lista o crea claves de API.

URL completa: https://api.aifoxapp.com/api/v1/api-keys/
Acceso: JWT
Entradas: name?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/api-keys/' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

DELETE/api-keys/{key_id}

Revoca una clave de API.

URL completa: https://api.aifoxapp.com/api/v1/api-keys/{key_id}
Acceso: JWT
Entradas: key_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X DELETE 'https://api.aifoxapp.com/api/v1/api-keys/{key_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

Reseller

GET/reseller/children

Lista o crea sub-organizaciones.

URL completa: https://api.aifoxapp.com/api/v1/reseller/children
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/reseller/children' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

POST/reseller/children

Lista o crea sub-organizaciones.

URL completa: https://api.aifoxapp.com/api/v1/reseller/children
Acceso: JWT de owner
Entradas: name, slug
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/reseller/children' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

PUT/reseller/branding

Actualiza el branding de la organización revendedora.

URL completa: https://api.aifoxapp.com/api/v1/reseller/branding
Acceso: JWT de owner
Entradas: branding (object)
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X PUT 'https://api.aifoxapp.com/api/v1/reseller/branding' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Notifications

POST/notifications/app/{app_id}/send

Envía push a los dispositivos correspondientes.

URL completa: https://api.aifoxapp.com/api/v1/notifications/app/{app_id}/send
Acceso: JWT
Entradas: app_id; title, body, channel_id?
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/notifications/app/{app_id}/send' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Migration

POST/migration/importar_do_github

Importa una configuración de CI reconocida desde GitHub.

URL completa: https://api.aifoxapp.com/api/v1/migration/importar_do_github
Acceso: JWT
Entradas: repo_url
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X POST 'https://api.aifoxapp.com/api/v1/migration/importar_do_github' \
  -H 'Authorization: Bearer $AIFOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Stats

GET/stats/dashboard

Devuelve estadísticas del panel de la organización.

URL completa: https://api.aifoxapp.com/api/v1/stats/dashboard
Acceso: JWT
Entradas: —
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/stats/dashboard' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

GET/stats/app/{app_id}

Devuelve estadísticas de un app.

URL completa: https://api.aifoxapp.com/api/v1/stats/app/{app_id}
Acceso: JWT
Entradas: app_id
Respuesta: 200/201: resultado de la operación en JSON. El formato exacto sigue el recurso devuelto por este handler.
Errores: Errores comunes: 401, 403, 404, 422, 429 y 503, según la operación.

curl -X GET 'https://api.aifoxapp.com/api/v1/stats/app/{app_id}' \
  -H 'Authorization: Bearer $AIFOX_TOKEN'

No público: POST /builds/ci-callback y POST /billing/webhook son integraciones internas y no deben ser llamadas por clientes.