Skip to content

Releases: flashdatadev/flashdata-go

FlashData Go SDK v1.1.0

Choose a tag to compare

@flashdatadev flashdatadev released this 23 Oct 10:07

FlashData Go v1.1.0

FlashData · API documentation

Use new WithFormat methods to choose JSON, plain text or Markdown for each call.
Existing typed JSON methods and their serialization remain compatible.

  • All 14 realtime source helpers and completed-job results support ContentOptions.
  • Submissions, batches and job status support ResponseOptions for JSON or text.
  • AcceptText selects plain text independently. RespondMarkdown selects Markdown
    content, either inside JSON content or following metadata in a text response.
  • FormattedResponse.JSON preserves wire fields and numbers; DecodeJSON accepts
    application models. Text contains the server's UTF-8 response.
  • Preserve job metadata, structured errors, gzip/size bounds, cancellation and
    credential separation for signed storage reads.

Requires Go 1.25+. Install or upgrade:

go get github.com/flashdatadev/flashdata-go@v1.1.0

See response formats for examples. The
GitHub release
provides the canonical Go module ZIP, .mod/.info metadata, both READMEs,
release notes, a build report and SHA256SUMS. Assets and the module tag identify
the same source commit. Normal Go installs retain checksum verification.

简体中文

1.1.0 新增按调用选择响应格式的 WithFormat 方法,原有 JSON 方法兼容。
AcceptText 独立选择纯文本;RespondMarkdown 用于实时内容和已完成结果。
后台提交、批量提交和任务状态也支持 JSON 或纯文本。保留任务元数据、错误类型、
响应大小限制和存储凭据隔离。需要 Go 1.25+。

FlashData Go v1.0.0

Choose a tag to compare

@flashdatadev flashdatadev released this 21 Oct 18:05

FlashData Go v1.0.0

FlashData · API documentation · English README · 简体中文

Initial version of the FlashData Go SDK. Install the public v1.0.0 source tag through Go tooling, or download the files from the official release.

Install

Requires Go 1.25 or newer:

go get github.com/flashdatadev/flashdata-go@v1.0.0

Pass your API key explicitly to flashdata.New(flashdata.Options{APIKey: key}). The SDK does not read environment variables or .env files. Get a key from your FlashData account.

Included

  • All 15 Google and YouTube sources, typed inputs and optional provider payload hints.
  • Realtime, background and mixed-source batch queries; accepted-job polling and result retrieval.
  • Complete bulk create/upload/start/control/recovery workflows, streaming results and customer-storage media delivery.
  • Public discovery and account reads, verified API-key identity, and protocol-2 machine onboarding.
  • Explicit timeouts and cancellation, isolated API-key/bearer/signed-storage authentication, redacted diagnostics, and recovery IDs for uncertain submissions without automatic paid retries.
  • English and Chinese READMEs, 22 runnable examples, API/reference documentation and offline regression tests.

Packages and verification

The assets contain flashdata-go_1.0.0.zip (canonical Go module ZIP), v1.0.0.mod, v1.0.0.info, build-report.json, current English/Chinese README files, these release notes and SHA256SUMS. The ZIP uses Go's standard github.com/flashdatadev/flashdata-go@v1.0.0/ prefix. Normal users install with Go rather than manually unpacking it.

The canonical module ZIP preserves the immutable tagged source snapshot. The separately attached READMEs contain the finalized installation instructions. build-report.json records the source commit, documentation commit, module checksums and validation. Check all downloaded assets from one directory:

sha256sum -c SHA256SUMS

PowerShell: use Get-FileHash -Algorithm SHA256 <file> and compare its hash with the corresponding SHA256SUMS entry. A checksum verifies the downloaded bytes; it is not a publisher signature.

Operational limits

Onboarding and recurring identity checks depend on server feature gates and the reviewed backend identity endpoint. Publishing this SDK does not deploy or enable those features. Paid production queries, live claiming/callbacks and customer cloud storage have not been exercised by the offline release checks. A timeout stops local waiting; accepted server work may continue. Preserve recovery IDs and reconcile uncertain submissions before intentional resubmission.

简体中文摘要

首个 Go SDK 版本,覆盖 15 个 Google/YouTube 数据源、实时/后台/批量查询、完整 Bulk 流程、账户读取和代理接入。需要 Go 1.25+,并显式传入 API 密钥。源码标签 v1.0.0 可通过 Go 安装;正式安装包和文档可从 GitHub Release 公开下载。附件提供标准 Go 模块 ZIP、模块元数据、构建记录及 SHA-256 校验和。接入功能仍受后端部署和服务端开关控制,离线检查不代表已验证真实付费调用或客户云存储。