跳到正文
cccskills
免费在 GitHub 公开

openapi-auth

Authenticate with the Openapi marketplace (oauth.openapi.com). Use when you need to create, inspect, renew or delete Bearer tokens, list available scopes, check wallet credit, subscriptions, or API usage stats. Required by every other openapi-* skill.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Openapi authentication (OAuth v2)

All Openapi services require a Bearer token created through OAuth v2. This skill manages that token lifecycle.

Credentials

Two layers — never confuse them:

  1. Account credentials (email + API key) → used only against https://oauth.openapi.com, as HTTP Basic auth (username = email, password = API key).
  2. Bearer token (created here, with scopes) → used against every service API as Authorization: Bearer <token>.

Expect credentials in the environment as OPENAPI_EMAIL, OPENAPI_API_KEY (and optionally a ready-made OPENAPI_TOKEN). Never print or commit them.

Create a token

curl -s -u "$OPENAPI_EMAIL:$OPENAPI_API_KEY" https://oauth.openapi.com/tokens \
  -H 'Content-Type: application/json' \
  -d '{
    "scopes": ["GET:company.openapi.com/IT-start"],
    "name": "agent token",
    "ttl": 86400
  }'
  • Scope format: METHOD:host/path-prefix (e.g. POST:sms.openapi.com/IT-messages). Request only the scopes the task needs, with a short ttl (max 1 year).
  • Discover valid scopes: GET https://oauth.openapi.com/scopes (Basic auth).
  • Optional limits object restricts token usage further.
  • A refresh token can renew a token: PATCH /tokens/{id} with the refresh token as Bearer.
  • Tokens can also be created from the console UI (Authentication → "+New Token") at https://console.openapi.com.

Management endpoints (Basic auth)

EndpointPurpose
GET /tokens, GET|PATCH|DELETE /tokens/{token}Token lifecycle
GET /scopes, GET /scopes/{id}Available scopes
GET /wallet, GET /wallet/transactionsCredit balance — check before expensive paid calls
GET /subscriptions, GET /subscriptions/{id}Active plans and remaining requests
GET /stats, GET /stats/apis, GET /stats/apis/{domain}, GET /stats/ipsUsage analytics
GET /errors, GET /callbacksError log and callback monitoring

Billing model (affects every service)

  • Requests are paid from the wallet (per request) or from a subscription (monthly: 30 days no rollover; annual: 365 days, any pace). Both can coexist; the wallet is the fallback when subscription requests run out.
  • Some APIs have free daily/monthly tiers; rate limits, when present, are stated in each API's description.
  • Sandbox: free test requests, but "sandbox credit" must be enabled in the console first; responses are illustrative.

Notes

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Vehicle data through Openapi Automotive - look up cars, motorcycles, insurance and MOT status by license plate across Italy, UK, Germany, France, Spain, Portugal. Use for vehicle technical data and insurance validity checks by plate.

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

Look up company/business data through Openapi - Italian companies by VAT/tax code or name, European and worldwide company search, shareholders, UBO, AML, PEC/SDI codes, company monitoring. Use for questions like "find data about company X", "who owns VAT number Y", "search companies in France/EU/worldwide".

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

Obtain official Italian documents through Openapi - chamber of commerce reports (visure camerali), financial statements/balance sheets, company files (fascicoli), bylaws, DURC, protest reports. Use when the user needs an official PDF document about an Italian company or person.

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

Digital signatures and time stamps through Openapi - eIDAS-compliant electronic signatures (SES with OTP, qualified QES, e-seals, massive automatic signing) and qualified time stamping of documents. Use when the user needs a document signed electronically or time-stamped with legal validity.

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

Italian geographic and property data through Openapi - geocoding/reverse geocoding, zip codes (CAP), municipalities/provinces/regions with ISTAT codes, Italian cadastre (catasto) property and owner lookups, visure catastali/ipotecarie, real estate valuations.

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

Italian electronic invoicing and payments through Openapi - send/receive electronic invoices via SDI (Sistema di Interscambio), digital receipts (scontrino elettronico), legal storage, and bill payments (MAV, RAV, PagoPA, car tax). Use for fatturazione elettronica and bill payment tasks.

中文简介正在准备中。当前显示原文说明。

openapi/openapi-skills152026年9月15日 更新

查看 openapi 的全部技能

报告此技能的问题