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

# Reconhecer um problema de dados

> Fecha o problema; a próxima ocorrência do mesmo abre um novo.



## OpenAPI

````yaml openapi/pt/cell.json POST /v1/data-issues/{issue_id}/ack
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-2
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/data-issues/{issue_id}/ack:
    post:
      tags:
        - turns
      summary: Reconhecer um problema de dados
      description: >-
        Fecha o problema; a próxima ocorrência do mesmo abre um novo.


        **Autenticação.** Token de pessoa do Console com o papel `integration`
        (ou admin), ou chave de fonte com o escopo `admin`. Só responde num
        espaço com uma das funcionalidades `turns`, `state` ligada (o documento
        `features`); num espaço sem nenhuma delas, 404.
      operationId: acknowledge_data_issue_v1_data_issues__issue_id__ack_post
      parameters:
        - in: path
          name: issue_id
          required: true
          schema:
            title: Issue Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataIssue'
          description: Resposta de sucesso.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: O pedido não bate com o contrato.
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    DataIssue:
      additionalProperties: false
      description: >-
        Um problema nos dados da empresa, devolvido ao dono deles sem dado
        pessoal: um problema aberto por classe, tipo, campo e fonte, contado
        cada vez que é achado de novo.
      properties:
        acknowledged_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Depois de reconhecido, a próxima ocorrência abre um problema novo.
          title: Acknowledged At
        field:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          title: Field
        issue_id:
          maxLength: 512
          minLength: 1
          title: Issue Id
          type: string
        kind:
          description: >-
            `null_field`, `out_of_vocabulary`, `stale_source`, `invalid_value`:
            um valor que a ferramenta de um agente mostrou; `coverage_drop`: um
            campo preenchido menos vezes que antes; `divergence`: duas fontes de
            um valor discordam; `drift`: o esquema que um tipo espelha mudou;
            `rule_conflict`: duas regras decidem uma coisa de jeitos diferentes;
            `type_undeclared`: ferramentas mostraram objetos de um tipo que o
            espaço nunca declarou.
          enum:
            - null_field
            - out_of_vocabulary
            - stale_source
            - coverage_drop
            - invalid_value
            - divergence
            - drift
            - rule_conflict
            - type_undeclared
          title: Kind
          type: string
        last_seen_at:
          format: date-time
          title: Last Seen At
          type: string
        object_type:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          title: Object Type
        occurrences:
          title: Occurrences
          type: integer
        opened_at:
          format: date-time
          title: Opened At
          type: string
        refs:
          description: Os primeiros objetos em que foi visto, até 50.
          items:
            description: >-
              An object as `<type>:<namespace>:<id>`, e.g.
              `item_variant:store:991`.
            pattern: ^[a-z][a-z0-9_]{0,39}:[^:\s]{1,256}:\S{1,512}$
            type: string
          maxItems: 50
          title: Refs
          type: array
        source:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          description: 'De onde o dado veio: uma ferramenta ou um sistema de registro.'
          title: Source
      required:
        - issue_id
        - kind
        - occurrences
        - opened_at
        - last_seen_at
      title: DataIssue
      type: object
    Problem:
      additionalProperties: false
      description: >-
        Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de
        erros versionado.
      properties:
        code:
          title: Code
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        type:
          default: about:blank
          title: Type
          type: string
      required:
        - title
        - status
        - code
      title: Problem
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````