hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "bytes": {
          "description": "File size in bytes.",
          "examples": [
            12331
          ],
          "type": "integer"
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "column_count": {
          "description": "Number of columns.",
          "examples": [
            14
          ],
          "type": "integer"
        },
        "columns": {
          "description": "Columns in file order.",
          "examples": [
            [
              "행정구역코드",
              "행정구역명",
              "성별",
              "내국인"
            ]
          ],
          "items": {
            "description": "Column name from the header row.",
            "examples": [
              "행정구역명"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "content_type": {
          "description": "Server content type.",
          "examples": [
            "application/octet-stream"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "encoding": {
          "description": "Text encoding used; null for XLSX.",
          "examples": [
            "cp949"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "file_url": {
          "description": "The file actually fetched.",
          "examples": [
            "https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003522968&fileDetailSn=1&insertDataPrcus=N"
          ],
          "type": "string"
        },
        "filename": {
          "description": "File name from the server or the URL.",
          "examples": [
            "울산광역시_인구 현황(20251112).csv"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "final_url": {
          "description": "After redirects.",
          "examples": [
            "https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003522968&fileDetailSn=1&insertDataPrcus=N"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "format": {
          "description": "Parsed format.",
          "enum": [
            "csv",
            "tsv",
            "xlsx",
            "json"
          ],
          "examples": [
            "csv"
          ],
          "type": "string"
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "45 data rows in the file; the first 5 are returned (max_rows)."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "resolved_from": {
          "description": "The dataset page that was resolved to a file link; null when a file link was given.",
          "examples": [
            "https://www.data.go.kr/data/15005995/fileData.do"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "row_count": {
          "description": "Rows returned.",
          "examples": [
            5
          ],
          "type": "integer"
        },
        "rows": {
          "description": "Rows in file order, up to max_rows.",
          "items": {
            "additionalProperties": true,
            "description": "One row keyed by column; numbers typed, blanks null.",
            "examples": [
              {
                "내국인": 564888,
                "성별": "남자",
                "행정구역명": "울산광역시",
                "행정구역코드": 31
              }
            ],
            "properties": {},
            "required": [],
            "type": "object"
          },
          "type": "array"
        },
        "sheet": {
          "description": "XLSX sheet read; null otherwise.",
          "examples": [
            "Sheet1"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "sheets": {
          "description": "All sheet names for an XLSX; empty otherwise.",
          "examples": [
            []
          ],
          "items": {
            "description": "Sheet name.",
            "examples": [
              "Sheet1"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "source_url": {
          "description": "The URL as given.",
          "examples": [
            "https://www.data.go.kr/data/15005995/fileData.do"
          ],
          "type": "string"
        },
        "total_rows": {
          "description": "Data rows in the file (excluding the header).",
          "examples": [
            45
          ],
          "type": "integer"
        },
        "truncated": {
          "description": "True when total_rows exceeds max_rows.",
          "examples": [
            true
          ],
          "type": "boolean"
        }
      },
      "required": [
        "source_url",
        "resolved_from",
        "file_url",
        "final_url",
        "filename",
        "content_type",
        "bytes",
        "format",
        "encoding",
        "sheet",
        "sheets",
        "columns",
        "column_count",
        "rows",
        "row_count",
        "total_rows",
        "truncated",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "opendata.table response",
  "type": "object"
}