Ir al contenido
AdiosDocumentación
Explorar la documentación

API de artefactos de código fuente

Lee los metadatos de las instantáneas de código fuente usados para las compilaciones y la carga del espacio de trabajo. Los artefactos se crean mediante la subida de código fuente y los flujos de compilación.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

MétodoRutaOperación
GET/v1/source_artifactListar artefactos de código fuente
GET/v1/source_artifact/{id}Obtener artefacto de código fuente

Listar artefactos de código fuente

GET /v1/source_artifact

Devuelve una lista paginada de SourceArtifact

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

NombreUbicaciónObligatorioDescripción
X-Tenant-IDcabecerasíID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
pageconsultanoNúmero de página
per_pageconsultanoElementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/source_artifact" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Lista de SourceArtifact

Campos de respuesta

CampoTipoDescripción
dataarray
data[].branchstring
data[].build_idstringCompilación producida a partir de esta instantánea del código fuente
data[].commit_shastring
data[].content_typestring
data[].created_atinteger(marca de tiempo Unix)
data[].deleted_atinteger(marca de tiempo Unix)
data[].digeststringHash del contenido del paquete de código fuente
data[].metadataobject
data[].repository_urlstringURL del repositorio Git cuando source_type es git
data[].size_bytesinteger
data[].source_artifact_idstring
data[].source_typestringValores permitidos: upload, git, workspace, template, unknown.
data[].system_artifact_idstringIdentificador del artefacto de objeto del sistema para el paquete de código fuente
data[].system_object_keystring
data[].system_uristring
data[].team_idstring
data[].updated_atinteger(marca de tiempo Unix)
data[].workload_idstring
paginationobject
pagination.pageintegerNúmero de página actual
pagination.per_pageintegerNúmero de elementos por página
pagination.totalintegerNúmero total de elementos

Ejemplo ilustrativo; no es una respuesta real:

{
  "data": [
    {
      "branch": "",
      "build_id": "example",
      "commit_sha": "",
      "content_type": "",
      "created_at": 1791072000,
      "deleted_at": 0,
      "digest": "",
      "metadata": {},
      "repository_url": "example",
      "size_bytes": 0,
      "source_artifact_id": "000000000000000000000000001",
      "source_type": "unknown",
      "system_artifact_id": "example",
      "system_object_key": "",
      "system_uri": "",
      "team_id": "000000000000000000000000001",
      "updated_at": 1791072000,
      "workload_id": "000000000000000000000000001"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Obtener artefacto de código fuente

GET /v1/source_artifact/{id}

Devuelve un único SourceArtifact

Configura source_artifact_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

NombreUbicaciónObligatorioDescripción
idrutasíIdentificador del recurso obtenido de los resultados de la API de tu equipo.
X-Tenant-IDcabecerasíID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/source_artifact/${ADIOS_SOURCE_ARTIFACT_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

SourceArtifact

Campos de respuesta

CampoTipoDescripción
branchstring
build_idstringCompilación producida a partir de esta instantánea del código fuente
commit_shastring
content_typestring
created_atinteger(marca de tiempo Unix)
deleted_atinteger(marca de tiempo Unix)
digeststringHash del contenido del paquete de código fuente
metadataobject
repository_urlstringURL del repositorio Git cuando source_type es git
size_bytesinteger
source_artifact_idstring
source_typestringValores permitidos: upload, git, workspace, template, unknown.
system_artifact_idstringIdentificador del artefacto de objeto del sistema para el paquete de código fuente
system_object_keystring
system_uristring
team_idstring
updated_atinteger(marca de tiempo Unix)
workload_idstring

Ejemplo ilustrativo; no es una respuesta real:

{
  "branch": "",
  "build_id": "example",
  "commit_sha": "",
  "content_type": "",
  "created_at": 1791072000,
  "deleted_at": 0,
  "digest": "",
  "metadata": {},
  "repository_url": "example",
  "size_bytes": 0,
  "source_artifact_id": "000000000000000000000000001",
  "source_type": "unknown",
  "system_artifact_id": "example",
  "system_object_key": "",
  "system_uri": "",
  "team_id": "000000000000000000000000001",
  "updated_at": 1791072000,
  "workload_id": "000000000000000000000000001"
}