Skip to content
cccskills
FreePublished on 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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

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".

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

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.

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

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.

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

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.

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

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.

The English summary is being prepared. Showing the original description.

openapi/openapi-skills15Updated Sep 15, 2026

See all skills by openapi

Report a problem with this skill