Skip to content

v2.2.0: sync SDK to live OpenAPI spec, skip deprecated endpoints - #44

Merged
callmeiks merged 4 commits into
mainfrom
v2
Oct 3, 2026
Merged

callmeiks merged 4 commits into
mainfrom
v2

Conversation

@callmeiks

Copy link
Copy Markdown
Member

Summary

Syncs the SDK to the live spec at https://api.tikhub.io/openapi.json and releases v2.2.0. The SDK now exposes 1048 endpoints across 51 resources, each with a sync and an async method.

This also brings the previously unmerged v2.1.2 spec sync (754d82f, 26d151b) into main.

Deprecated endpoints are no longer generated

  • scripts/generate_resources.py skips operations marked deprecated: true.
  • scripts/verify_coverage.py and the endpoint-count test count only non-deprecated operations.
  • This drops 2 endpoints: tiktok_shop_web.fetch_product_detail_v2 and tiktok_shop_web.fetch_hot_selling_products_list.

Upstream changes

  • Removed resources (breaking): linkedin_web, sora2, temp_mail, tiktok_interaction, wechat_channels, wechat_media_platform_web, weibo_web, xiaohongshu_app, xiaohongshu_web, xiaohongshu_web_v2.
  • New resources: bilibili_huahuo (45), douyin_douplus (17), xiaohongshu_pgy (20), wechat_channels_v2 (12), wechat_media_platform_v2 (11), wechat_search_v2 (2), telegram_web (7).
  • Existing resources: endpoints were added to or removed from about 25 of them. The largest changes are linkedin_web_v2 (−35), douyin_xingtu_v2 (+29), tiktok_ads (+8/−23), tiktok_app_v3 (−17), twitter_web (+13) and douyin_web (−11).

Also updated

  • Regenerated examples/ and docs/reference.md.
  • Platform tables and counts in all 5 READMEs and examples/README.md.
  • docs/index.md, docs/naming.md, docs/migrating-from-v2.md, and CHANGELOG.md ([2.2.0]).
  • Version set to 2.2.0 in pyproject.toml and _version.py.

Test plan

  • pytest: 108 passed
  • ruff check src tests scripts: clean
  • mypy src/tikhub: clean (70 files)
  • scripts/verify_coverage.py: 1048 / 1048, nothing extra
  • No method calls in the README, docs, CLI or examples/quickstart.py point at removed methods

Note: the v2.2.0 tag has already been pushed on 0cb40ed (the head of this branch).

🤖 Generated with Claude Code

https://claude.ai/code/session_013s1sVaxRsEZxrkwsj86ZBB

callmeiks and others added 4 commits June 1, 2026 18:57
Regenerate the SDK from the latest https://api.tikhub.io/openapi.json:
1010 -> 1106 endpoints (+121 added, -25 removed). Two new platforms:
client.douyin_index (44) and client.linkedin_web_v2 (43).

- Regenerated resources, both clients, examples, and docs/reference.md.
- Fix scripts/refresh_spec.py: send a browser User-Agent (the API now
  rejects urllib's default UA with HTTP 403).
- Make test_total_endpoint_count spec-derived instead of hardcoding 1010,
  so it no longer breaks on a spec bump.
- Update human-facing counts across READMEs, docs, examples/README, and the
  CHANGELOG Unreleased entry (released history untouched).

Verified: verify_coverage 1106/1106; an independent param check confirms all
1106 methods' parameter names and required/optional flags match the spec
exactly; 110 tests, ruff, and mypy all green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Release the V5.3.2 spec sync (1106 endpoints, two new platforms).
Bump _version.py + pyproject.toml to 2.1.2 and cut the CHANGELOG
[Unreleased] section into a dated [2.1.2] release.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…nts)

Refresh spec/openapi.json from https://api.tikhub.io/openapi.json (1050
operations, 51 tags) and regenerate resources, clients, examples and the
API reference.

The generator now skips operations marked `deprecated: true`, and
verify_coverage.py plus the endpoint-count test count only non-deprecated
operations. This drops tiktok_shop_web.fetch_product_detail_v2 and
fetch_hot_selling_products_list.

Upstream removed linkedin_web, sora2, temp_mail, tiktok_interaction,
wechat_channels, wechat_media_platform_web, weibo_web, xiaohongshu_app,
xiaohongshu_web and xiaohongshu_web_v2, and added bilibili_huahuo,
douyin_douplus, telegram_web, wechat_channels_v2,
wechat_media_platform_v2, wechat_search_v2 and xiaohongshu_pgy. READMEs,
docs and the examples index are updated to match.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013s1sVaxRsEZxrkwsj86ZBB
Release the live-spec sync (1048 endpoints across 51 resources, deprecated
endpoints excluded). Minor bump because several resources were removed
upstream. Bump _version.py + pyproject.toml to 2.2.0 and cut the CHANGELOG
[Unreleased] section into a dated [2.2.0] release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013s1sVaxRsEZxrkwsj86ZBB
@callmeiks
callmeiks merged commit 1ede56b into main Oct 3, 2026
10 checks passed

This branch was successfully deployed

1 active deployment
pypi — 0cb40ede Deployed Oct 3, 2026 by callmeiks via publish #10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant