Telnyx REST API v2 Fundamentals

Telnyx 官方基础文档确认 v2 REST、JSON 与 Bearer API-key，提供 GET /balance 作为首个认证检查示例；产品级字段、费用和限流需另核，本次未调用。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-130bf5184e09c798423cb1e2
Card version: 2
Updated: 2026-10-24T18:33:37.0464549+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

本次官方 API fundamentals 给出基础地址 https://api.telnyx.com/v2，REST默认使用JSON请求/响应与Bearer API-key，除非具体端点另有说明。页面以GET /balance作为初次认证检查的示例，但没有展开余额响应字段。区域API示例 https://api.telnyx.eu/v2 提供同一API表面；此描述不构成数据驻留或所有产品使用同一协议的保证。

Inputs

代表GET /balance需按正式认证条件提供API key；正文未列附加查询参数。
其他REST端点的JSON字段、分页、过滤与排序只使用该端点明确声明的参数。

Outputs

REST约定JSON请求/响应与成功/错误envelopes；GET /balance具体字段未在本页展开。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u6B63\u6587\u89C4\u5B9AREST\u9ED8\u8BA4Bearer API-key\uFF0C\u5177\u4F53\u7AEF\u70B9\u53EF\u6709\u4F8B\u5916\u3002\u6709\u6548server-side\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\uFF1B\u672C\u6B21\u672A\u521B\u5EFA\u3001\u8BFB\u53D6\u6216\u4F7F\u7528\u5B9E\u9645key\u3002"
  },
  "command": null,
  "entry_url": "https://api.telnyx.com/v2/balance",
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "credential_requirement": "\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u6709\u6548server-side API key",
    "documentation_text": "\u672C\u9875\u4EE3\u8868\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://api.telnyx.com/v2/balance\u3002\u4F7F\u7528\u6587\u6863\u89C4\u5B9A\u7684Bearer API-key\u8BA4\u8BC1\uFF1B\u6240\u6709\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u3002",
    "method": "GET",
    "url": "https://api.telnyx.com/v2/balance"
  },
  "requirements": [
    "\u5177\u5907\u6709\u6548Telnyx server-side API key\uFF0C\u5E76\u6309\u5B9E\u9645\u7AEF\u70B9\u6743\u9650\u8C03\u7528\u3002",
    "\u4EE3\u8868\u5165\u53E3\u7531\u6B63\u6587base URL\u4E0E\u660E\u786EGET /balance\u793A\u4F8B\u7EC4\u5408\uFF1B\u672C\u9875\u672A\u63D0\u4F9B\u66F4\u7EC6\u54CD\u5E94schema\u3002",
    "\u4EA7\u54C1\u8C03\u7528\u5E94\u6838\u5BF9\u5E94\u6B63\u5F0F\u7AEF\u70B9\u65B9\u6CD5/\u5B57\u6BB5\uFF1B\u672C\u6B21\u4E0D\u4ECE\u5BFC\u822A\u8865\u9020\u901A\u4FE1\u3001\u5B58\u50A8\u6216\u5176\u4ED6\u4EA7\u54C1\u8BF7\u6C42\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u672C\u6B21\u57FA\u7840\u9875\u672A\u7ED9API\u6216\u5177\u4F53\u4EA7\u54C1\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u9650\u901F\u548C\u914D\u989D\uFF1BPricing\u5BFC\u822A\u672A\u8BFB\u53D6\u3002",
  "source_url": "https://developers.telnyx.com/docs/development/api-fundamentals"
}

{
  "location": "provider_server",
  "notes": "REST\u8BF7\u6C42\u4E0E\u51ED\u636E\u53D1\u81F3\u6240\u9009Telnyx\u6258\u7BA1API\u533A\u57DF\u5165\u53E3\uFF1B\u771F\u5B9E\u5904\u7406/\u4FDD\u5B58\u5730\u533A\u3001\u65E5\u5FD7\u4FDD\u7559\u53CA\u4EA7\u54C1\u6570\u636E\u6761\u4EF6\u672A\u7531\u672C\u9875\u786E\u8BA4\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

默认REST认证/JSON约定存在端点例外，不能泛化到所有产品。
Cloud Storage S3、WebRTC、WebSocket及webhook投递采用各自协议，应另核产品文档。
区域API同表面不等于已验证数据驻留、账户权限或区域产品可用性。
本页只有限流/重试导航，没有具体速率、配额或完整错误schema。
未调用balance、发送通信、启用存储或测试任何产品。

Unknowns

实际账户/key权限、余额和端点例外条件未知。
余额JSON schema、产品级请求/响应/错误与分页细节未知。
价格、免费额度、具体限速与配额未知。
数据保留、实际驻留与产品专属处理条件未知。
未创建key、认证、请求API或进行通信操作。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T18:32:37.9083383\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developers.telnyx.com/docs/development/api-fundamentals"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "REST\u8BF7\u6C42\u4E0E\u51ED\u636E\u53D1\u81F3\u6240\u9009Telnyx\u6258\u7BA1API\u533A\u57DF\u5165\u53E3\uFF1B\u771F\u5B9E\u5904\u7406/\u4FDD\u5B58\u5730\u533A\u3001\u65E5\u5FD7\u4FDD\u7559\u53CA\u4EA7\u54C1\u6570\u636E\u6761\u4EF6\u672A\u7531\u672C\u9875\u786E\u8BA4\u3002"
  },
  "description": "\u672C\u6B21\u5B98\u65B9 API fundamentals \u7ED9\u51FA\u57FA\u7840\u5730\u5740 https://api.telnyx.com/v2\uFF0CREST\u9ED8\u8BA4\u4F7F\u7528JSON\u8BF7\u6C42/\u54CD\u5E94\u4E0EBearer API-key\uFF0C\u9664\u975E\u5177\u4F53\u7AEF\u70B9\u53E6\u6709\u8BF4\u660E\u3002\u9875\u9762\u4EE5GET /balance\u4F5C\u4E3A\u521D\u6B21\u8BA4\u8BC1\u68C0\u67E5\u7684\u793A\u4F8B\uFF0C\u4F46\u6CA1\u6709\u5C55\u5F00\u4F59\u989D\u54CD\u5E94\u5B57\u6BB5\u3002\u533A\u57DFAPI\u793A\u4F8B https://api.telnyx.eu/v2 \u63D0\u4F9B\u540C\u4E00API\u8868\u9762\uFF1B\u6B64\u63CF\u8FF0\u4E0D\u6784\u6210\u6570\u636E\u9A7B\u7559\u6216\u6240\u6709\u4EA7\u54C1\u4F7F\u7528\u540C\u4E00\u534F\u8BAE\u7684\u4FDD\u8BC1\u3002",
  "inputs": [
    "\u4EE3\u8868GET /balance\u9700\u6309\u6B63\u5F0F\u8BA4\u8BC1\u6761\u4EF6\u63D0\u4F9BAPI key\uFF1B\u6B63\u6587\u672A\u5217\u9644\u52A0\u67E5\u8BE2\u53C2\u6570\u3002",
    "\u5176\u4ED6REST\u7AEF\u70B9\u7684JSON\u5B57\u6BB5\u3001\u5206\u9875\u3001\u8FC7\u6EE4\u4E0E\u6392\u5E8F\u53EA\u4F7F\u7528\u8BE5\u7AEF\u70B9\u660E\u786E\u58F0\u660E\u7684\u53C2\u6570\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u6B63\u6587\u89C4\u5B9AREST\u9ED8\u8BA4Bearer API-key\uFF0C\u5177\u4F53\u7AEF\u70B9\u53EF\u6709\u4F8B\u5916\u3002\u6709\u6548server-side\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\uFF1B\u672C\u6B21\u672A\u521B\u5EFA\u3001\u8BFB\u53D6\u6216\u4F7F\u7528\u5B9E\u9645key\u3002"
    },
    "command": null,
    "entry_url": "https://api.telnyx.com/v2/balance",
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "credential_requirement": "\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u6709\u6548server-side API key",
      "documentation_text": "\u672C\u9875\u4EE3\u8868\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://api.telnyx.com/v2/balance\u3002\u4F7F\u7528\u6587\u6863\u89C4\u5B9A\u7684Bearer API-key\u8BA4\u8BC1\uFF1B\u6240\u6709\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u3002",
      "method": "GET",
      "url": "https://api.telnyx.com/v2/balance"
    },
    "requirements": [
      "\u5177\u5907\u6709\u6548Telnyx server-side API key\uFF0C\u5E76\u6309\u5B9E\u9645\u7AEF\u70B9\u6743\u9650\u8C03\u7528\u3002",
      "\u4EE3\u8868\u5165\u53E3\u7531\u6B63\u6587base URL\u4E0E\u660E\u786EGET /balance\u793A\u4F8B\u7EC4\u5408\uFF1B\u672C\u9875\u672A\u63D0\u4F9B\u66F4\u7EC6\u54CD\u5E94schema\u3002",
      "\u4EA7\u54C1\u8C03\u7528\u5E94\u6838\u5BF9\u5E94\u6B63\u5F0F\u7AEF\u70B9\u65B9\u6CD5/\u5B57\u6BB5\uFF1B\u672C\u6B21\u4E0D\u4ECE\u5BFC\u822A\u8865\u9020\u901A\u4FE1\u3001\u5B58\u50A8\u6216\u5176\u4ED6\u4EA7\u54C1\u8BF7\u6C42\u3002"
    ]
  },
  "limitations": [
    "\u9ED8\u8BA4REST\u8BA4\u8BC1/JSON\u7EA6\u5B9A\u5B58\u5728\u7AEF\u70B9\u4F8B\u5916\uFF0C\u4E0D\u80FD\u6CDB\u5316\u5230\u6240\u6709\u4EA7\u54C1\u3002",
    "Cloud Storage S3\u3001WebRTC\u3001WebSocket\u53CAwebhook\u6295\u9012\u91C7\u7528\u5404\u81EA\u534F\u8BAE\uFF0C\u5E94\u53E6\u6838\u4EA7\u54C1\u6587\u6863\u3002",
    "\u533A\u57DFAPI\u540C\u8868\u9762\u4E0D\u7B49\u4E8E\u5DF2\u9A8C\u8BC1\u6570\u636E\u9A7B\u7559\u3001\u8D26\u6237\u6743\u9650\u6216\u533A\u57DF\u4EA7\u54C1\u53EF\u7528\u6027\u3002",
    "\u672C\u9875\u53EA\u6709\u9650\u6D41/\u91CD\u8BD5\u5BFC\u822A\uFF0C\u6CA1\u6709\u5177\u4F53\u901F\u7387\u3001\u914D\u989D\u6216\u5B8C\u6574\u9519\u8BEFschema\u3002",
    "\u672A\u8C03\u7528balance\u3001\u53D1\u9001\u901A\u4FE1\u3001\u542F\u7528\u5B58\u50A8\u6216\u6D4B\u8BD5\u4EFB\u4F55\u4EA7\u54C1\u3002"
  ],
  "outputs": [
    "REST\u7EA6\u5B9AJSON\u8BF7\u6C42/\u54CD\u5E94\u4E0E\u6210\u529F/\u9519\u8BEFenvelopes\uFF1BGET /balance\u5177\u4F53\u5B57\u6BB5\u672A\u5728\u672C\u9875\u5C55\u5F00\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u6B21\u57FA\u7840\u9875\u672A\u7ED9API\u6216\u5177\u4F53\u4EA7\u54C1\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u9650\u901F\u548C\u914D\u989D\uFF1BPricing\u5BFC\u822A\u672A\u8BFB\u53D6\u3002",
    "source_url": "https://developers.telnyx.com/docs/development/api-fundamentals"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [
    "Telnyx \u5B98\u65B9 REST API v2 \u57FA\u7840\u5730\u5740",
    "Telnyx Bearer API key \u548C GET balance",
    "Telnyx REST \u4E0E\u4EA7\u54C1\u4E13\u5C5E\u534F\u8BAE\u8FB9\u754C"
  ],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-24T18:32:37.9083383\u002B00:00",
      "title": "API fundamentals - Telnyx",
      "url": "https://developers.telnyx.com/docs/development/api-fundamentals"
    }
  ],
  "summary": "Telnyx \u5B98\u65B9\u57FA\u7840\u6587\u6863\u786E\u8BA4 v2 REST\u3001JSON \u4E0E Bearer API-key\uFF0C\u63D0\u4F9B GET /balance \u4F5C\u4E3A\u9996\u4E2A\u8BA4\u8BC1\u68C0\u67E5\u793A\u4F8B\uFF1B\u4EA7\u54C1\u7EA7\u5B57\u6BB5\u3001\u8D39\u7528\u548C\u9650\u6D41\u9700\u53E6\u6838\uFF0C\u672C\u6B21\u672A\u8C03\u7528\u3002",
  "tags": [
    "Telnyx",
    "REST API",
    "v2",
    "JSON",
    "developer fundamentals",
    "documentation"
  ],
  "terms_url": null,
  "title": "Telnyx REST API v2 Fundamentals",
  "unknowns": [
    "\u5B9E\u9645\u8D26\u6237/key\u6743\u9650\u3001\u4F59\u989D\u548C\u7AEF\u70B9\u4F8B\u5916\u6761\u4EF6\u672A\u77E5\u3002",
    "\u4F59\u989DJSON schema\u3001\u4EA7\u54C1\u7EA7\u8BF7\u6C42/\u54CD\u5E94/\u9519\u8BEF\u4E0E\u5206\u9875\u7EC6\u8282\u672A\u77E5\u3002",
    "\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u5177\u4F53\u9650\u901F\u4E0E\u914D\u989D\u672A\u77E5\u3002",
    "\u6570\u636E\u4FDD\u7559\u3001\u5B9E\u9645\u9A7B\u7559\u4E0E\u4EA7\u54C1\u4E13\u5C5E\u5904\u7406\u6761\u4EF6\u672A\u77E5\u3002",
    "\u672A\u521B\u5EFAkey\u3001\u8BA4\u8BC1\u3001\u8BF7\u6C42API\u6216\u8FDB\u884C\u901A\u4FE1\u64CD\u4F5C\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T18:32:37.9083383\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developers.telnyx.com/docs/development/api-fundamentals"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-130bf5184e09c798423cb1e2",
  "version": 2,
  "source_url": "https://developers.telnyx.com/docs/development/api-fundamentals",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://developers.telnyx.com/docs/development/api-fundamentals",
    "final_url": "https://developers.telnyx.com/docs/development/api-fundamentals",
    "status_code": 200,
    "title": "API fundamentals - Telnyx",
    "description": "Authenticate, make a first request, handle responses and failures, and operate Telnyx REST API integrations reliably.",
    "checked_at": "2026-10-24T18:32:37.9083383\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T18:32:41.9689806\u002B00:00",
  "updated_at": "2026-10-24T18:33:37.0464549\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-130bf5184e09c798423cb1e2?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-130bf5184e09c798423cb1e2?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "Telnyx \u901A\u4FE1\u5E73\u53F0 REST \u63A5\u5165\u57FA\u7840",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-2ba5fb504d102d5e4d7e844ef7ef8764",
        "source_url": "https://developers.telnyx.com/docs/development/api-fundamentals",
        "content_sha256": "341a7db185cd1ebbf4db80e49f19037a5bf14685ecd65a689189ae757915a8ca",
        "decoded_bytes": 795945,
        "content_type": "text/html",
        "captured_at": "2026-10-24T18:32:37.9083383\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "341a7db185cd1ebbf4db80e49f19037a5bf14685ecd65a689189ae757915a8ca",
        "text_utf8_bytes": 795945,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-130bf5184e09c798423cb1e2/materials/material-2ba5fb504d102d5e4d7e844ef7ef8764?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-0dca1d78e01247df84b85ed998ae73e9",
    "reason": "\u4F9D\u636E\u672C\u6B21\u5B98\u65B9\u57FA\u7840\u9875\u6574\u7406v2 base\u3001\u660E\u786EGET /balance\u4E0EBearer/JSON\u7EA6\u5B9A\uFF0C\u4FDD\u7559\u4EA7\u54C1\u534F\u8BAE\u4F8B\u5916\u548Cschema/\u8D39\u7528\u7F3A\u53E3\uFF1B\u793A\u4F8B\u4EC5\u8BF4\u660E\u51ED\u636E\u7531\u4F7F\u7528\u8005\u63D0\u4F9B\u3002",
    "source_urls": [
      "https://developers.telnyx.com/docs/development/api-fundamentals"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-130bf5184e09c798423cb1e2",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-130bf5184e09c798423cb1e2?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-130bf5184e09c798423cb1e2?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure