浅谈一款代码检测神器

世界运行在代码之上。我们生活的几乎每一个方面都以某种方式、形状或形式由代码处理。它可能隐藏并在幕后运行，但它始终存在于我们的日常活动中。借助我们的闹钟或手机应用程序在早上醒来，在智能设备或电视上阅读新闻和媒体，为堂食、外卖或外卖订购食物，甚至只是导航从 A 点到另一点的交通B——代码是这一切背后的驱动力。

因此，运行世界的代码呈指数级增长，并且随着越来越多的应用程序和服务旨在渗透到我们的生活中，它每天都在继续增长。大部分代码不仅仅存在于一个人的计算机上。团队正在编写、共享和讨论它，而用于共享和讨论代码的工具跟不上。

但这不仅仅是一个“团队”问题。您是否曾经在没有标记或分类的网站上遇到过代码片段？你当然有。我们都有！

开发人员需要工具来帮助检测、标记、格式化和丰富他们的代码，而代码检测 API正是为此目的而创建的。

什么是代码检测 API？

代码检测 API 是由Runtime和APILayer共同构建的代码处理器。Runtime 的重点是开拓代码的检测、处理、标记、丰富和转换——也称为技术语言处理。他们负责Pieces应用程序，该应用程序可以立即保存代码片段、从屏幕截图中提取代码以及从这些片段中自动完成代码。APILayer 不仅构建了可扩展且高性能的 RESTful API，还构建了这些 API 运行的几乎始终在线的基础架构。

Code Detection API 使用简单，可以判断提供的字符串是自然语言还是技术语言（即代码）。如果它检测到代码，它会以高准确度识别语言。最好的部分是代码检测 API 的速度；分析和识别提供的输入只需要大约 250 毫秒。它不仅速度极快，而且最大限度地减少了设备上的计算资源。

因此，无论您正在构建什么软件，无论是文档站点、论坛、在线代码编辑器还是以开发人员为中心的工具，您都需要代码检测 API。

为什么使用代码检测 API？

代码检测 API 是一个易于使用的 API，用于检测、处理、标记、丰富和转换代码，您将找不到任何其他服务或解决方案可以提供所有这些功能：

快速代码检测

代码检测 API 使用运行时的机器学习模型确定提供的文本字符串是否包含代码片段。

准确分类

技术语言种类繁多，代码检测 API 准确检测 30 种语言，包括 JavaScript、PHP、C#、Ruby、Go、HTML、Markdown、C 和 C++。

丰富和转换片段

代码检测 API 可以生成代码的语法突出显示和截断版本。

改善搜索引擎优化

使用代码检测 API 对您网站的代码片段进行分类，并使用生成的元数据来改进索引，这将提高您网站的知名度。

高度可扩展

代码检测 API 运行在 APILayer 的云基础设施上，它可以满足您最小和最大的需求。

无与伦比的速度

Runtime 的技术语言处理器在几毫秒内分析代码，APILayer 通过其闪电般的基础设施提供响应。

接近 100% 的正常运行时间

虽然没有什么是 100%，但 APILayer 服务的正常运行时间已经接近了。

这个怎么运作

开始使用代码检测 API 很容易。首先，您需要创建一个 Runtime.dev 帐户。验证您的电子邮件地址并登录后，您将进入运行时开发者控制台。

您需要一个 API 密钥才能使用代码检测 API，虽然从技术上讲，您可以免费检索一个（试用 14 天），但您必须提供信用卡才能开始试用。要获取密钥，请单击 Runtime Developer Console 中的Discover Products 按钮，选择您想要的计划，然后输入您的付款信息。

开始试用后，您将被重定向回Runtime Developer Console，您将在其中找到您的 API 密钥（和机密），以及使用 cURL 的示例请求及其响应。

快速教程

让我们使用代码检测 API 来评估一些任意文本。然而，重要的是要注意，代码检测 API 在撰写本文时不支持 CORS。因此，您不能在浏览器中使用 JavaScript 直接发送请求。因此，以下代码示例将使用 PHP 和Guzzle HTTP 库。注意：Guzzle 库不是必需的；您可以使用 cURL 函数获得相同的结果。

Client()首先，通过调用构造函数创建一个 Guzzle HTTP 客户端对象：

$client = new GuzzleHttp\Client();

下一步是向POST代码检测 API 发送请求。请求应包含apiKey设置为您的 API 密钥的 URL 参数，请求正文必须为 JSON 格式，如以下代码所示：

$response = $client->request('POST', 'https://api.runtime.dev/tlp?apikey=your_api_key', [
    'json' => [
        'iterable' => [
            ['value' => '$my_obj->method();']
        ]
    ]
]);

此代码使用客户端对象的request()方法并传递三个参数。第一个参数是 HTTP 方法，第二个是发送请求的 URL，第三个是指定请求正文的数组。发送 JSON，body 数组的 key 必须是 string json，它的 value 是一个对象或数组，可以序列化成如下结构：

{
  "iterable": [
    { "value": "text to process" }
  ]
}

该iterable属性是一个输入数组。每个输入都是一个具有value属性的对象，其值是代码检测 API 应该评估的文本。您必须在请求中包含至少一项输入。

API 使用 JSON 有效负载进行响应。以下是上述请求的截断响应：

与请求一样，响应有一个名为 的属性iterable，它是一个数组，其中包含对请求输入的结果分析。如您所料，响应数组的索引与请求数组iterable中的索引直接对应。iterable

每个结果都有naturalLanguage和codeClassification属性，每个都是具有result属性的对象。naturalLanguage对象的属性result告诉您提供的输入是否是自然文本。如果提供的输入是代码，则resultforcodeClassification提供各种信息。

说到代码，让我们回到它。自然，您需要将 JSON 响应解码为对象：

$data = json_decode($response->getBody());
$data->iterable[0]->naturalLanguage->result; // false in this case
$data->iterable[0]->codeClassification->result->current; // the language of the input; PHP in this case 
$data->iterable[0]->codeClassification->result->likelihood; // percentage of surety the input is the current’s language

价钱

代码检测 API 有三个订阅计划。每个计划都会授予您 API 积分和各种功能。显然，更高级别的订阅会授予更多 API 积分并提供额外的功能。

没有免费计划；但是，无论您选择哪种订阅，您都可以获得 14 天的免费试用期。您必须提供信用卡才能开始试用。

结论

开发人员必须应对的代码继续呈指数增长。如果您或您的团队正在编写允许开发人员查看、共享和讨论代码的软件，那么您需要将代码检测 API 集成到您的应用程序中。入门快速而简单