API 设计规范

2024-05-09 07:32

1. API 设计规范

 设计时通过将请求和响应之间的不同部分隔离来让事情变得简单。保持简单的规则让我们能更关注在一些更大的更困难的问题上。
   请求和响应将解决一个特定的资源或集合。使用路径(path)来表明身份,body来传输内容(content)还有头信息(header)来传递元数据(metadata)。查询参数同样可以用来传递头信息的内容,但头信息是首选,因为他们更灵活、更能传达不同的信息。
   所有的访问API行为,都需要用TLS通过安全连接来访问。没有必要搞清或解释什么情况需要TLS 什么情况不需要TLS,直接强制任何访问都要通过 TLS。
   理想状态下,通过拒绝所有非TLS请求,不响应http或80端口的请求以避免任何不安全的数据交换。如果现实情况中无法这样做,可以返回403 Forbidden响应。
   把非TLS的请求重定向(Redirect)至TLS连接是不明智的,这种含混/不好的客户端行为不会带来明显好处。依赖于重定向的客户端访问不仅会导致双倍的服务器负载,还会使 TLS 加密失去意义,因为在首次非TLS调用时,敏感信息就已经暴露出去了。
   制定版本并在版本之间平缓过渡对于设计和维护一套API是个巨大的挑战。所以,最好在设计之初就使用一些方法来预防可能会遇到的问题。
   为了避免API的变动导致用户使用中产生意外结果或调用失败,最好强制要求所有访问都需要指定版本号。请避免提供默认版本号,一旦提供,日后想要修改它会相当困难。
   最适合放置版本号的位置是头信息(HTTP Headers),在 Accept 段中使用自定义类型(contenttype)与其他元数据(metadata)一起提交。例如:
   在所有返回的响应中包含ETag头信息,用来标识资源的版本。这让用户对资源进行缓存处理成为可能,在后续的访问请求中把If-None-Match头信息设置为之前得到的ETag值,就可以侦测到已缓存的资源是否需要更新。
   为每一个请求响应包含一个Request-Id头,并使用UUID作为该值。通过在客户端、服务器或任何支持服务上记录该值,它能为我们提供一种机制来跟踪、诊断和调试请求。
   一个大的响应应该通过多个请求使用Range头信息来拆分,并指定如何取得。详细的请求和响应的头信息(header),状态码(status code),范围(limit),排序(ordering)和迭代(iteration)等,参考 Heroku PlatformAPI discussion of Ranges .
   在 PUT/PATCH/POST 请求的正文(request bodies)中使用JSON格式数据,而不是使用form 表单形式的数据。这与我们使用JSON格式返回请求相对应,例如:
    资源名 (Resource names):使用复数形式为资源命名,除非这个资源在系统中是单例的 (例如,在大多数系统中,给定的用户帐户只有一个)。 这种方式保持了特定资源的统一性。
    行为 (Actions):好的末尾不需要为资源指定特殊的行为,但在特殊情况下,为某些资源指定行为却是必要的。为了描述清楚,在行为前加上一个标准的actions:
   例如:
   为了和域名命名规则保持一致,使用小写字母并用 - 分割路径名字,例如:
   属性也使用小写字母,但是属性名要用下划线 _ 分割,以便在Javascript****中省略引号。例如:
   在某些情况下,让用户提供ID去定位资源是不方便的。例如,一个用户想取得他在Heroku平台app信息,但是这个app的唯一标识是UUID。这种情况下,你应该支持接口通过名字和ID都能访问,例如:
   不要只接受使用名字而放弃了使用id。
   在一些有父路径/子路径嵌套关系的资源数据模块中,路径可能有非常深的嵌套关系,例如:
   推荐在根(root)路径下指定资源来限制路径的嵌套深度。使用嵌套指定范围的资源。在上述例子中,dyno属于app,app属于org可以表示为:
   为每一次的响应返回合适的HTTP状态码。好的响应应该使用如下的状态码:
   200: GET请求成功,及DELETE或PATCH同步请求完成,或者PUT同步更新一个已存在的资源;
   201: POST同步请求完成,或者PUT同步创建一个新的资源;
   202: POST,PUT,DELETE,或PATCH请求接收,将被异步处理;
   206: GET 请求成功,但是只返回一部分;
   使用身份认证(authentication)和授权(authorization)错误码时需要注意:
   401 Unauthorized: 用户未认证,请求失败;
   403 Forbidden: 用户无权限访问该资源,请求失败;
   当用户请求错误时,提供合适的状态码可以提供额外的信息:
   422 Unprocessable Entity: 请求被服务器正确解析,但是包含无效字段;
   429 Too Many Requests: 因为访问频繁,你已经被限制访问,稍后重试;
   500 Internal Server Error: 服务器错误,确认状态并报告问题.
   对于用户错误和服务器错误情况状态码,参考: ** **HTTP response code spec 
   提供全部可显现的资源表述 (例如:这个对象的所有属性) ,当响应码为200或是201时返回所有可用资源,包含 PUT/PATCH和 DELETE 请求,例如:
   当请求状态码为202时,不返回所有可用资源,例如:
   在默认情况给每一个资源一个id属性。除非有更好的理由,否则请使用UUID。不要使用那种在服务器上或是资源中不是全局唯一的标识,尤其是自动增长的id。
   生成小写的UUID格式 8-4-4-4-12,例如:
   为资源提供默认的创建时间 created_at 和更新时间 updated_at,例如:
   有些资源不需要使用时间戳那么就忽略这两个字段。
   仅接受和返回UTC格式的时间。ISO8601格式的数据,例如:
   使用嵌套对象序列化外键关联,例如:
   而不是像这样:
   这种方式尽可能的把相关联的资源信息内联在一起,而不用改变资源的结构,或者引入更多的顶层字段,例如:
   响应错误的时,生成统一的、结构化的错误信息。包含一个机器可读的错误 id,一个人类可读的错误信息(message),根据情况可以添加一个url来告诉客户端关于这个错误的更多信息以及如何去解决它,例如:
   文档化错误信息格式,以及客户端可能遇到的错误信息id。
   客户端的访问速度限制可以维护服务器的良好状态,保证为其他客户端请求提供高性的服务。你可以使用   token bucket algorithm   技术量化请求限制。
   为每一个带有RateLimit-Remaining响应头的请求,返回预留的请求tokens。
   请求中多余的空格会增加响应大小,而且现在很多的HTTP客户端都会自己输出可读格式("prettify")的JSON。所以最好保证响应JSON最小化,例如:
   而不是这样:
   你可以提供可选的方式为客户端提供更详细可读的响应,使用查询参数(例如:?pretty=true)或者通过Accept头信息参数(例如:Accept:application/vnd.heroku+json;version=3; indent=4;)。
   提供一个机器可读的模式来恰当的表现你的API。使用    prmd   管理你的模式,并且确保用prmd verify验证是有效的。
   提供人类可读的文档让客户端开发人员可以理解你的API。
   如果你用prmd创建了一个概要并且按上述要求描述,你可以为所有节点很容易的使用prmd doc生成Markdown文档。
   除了节点信息,提供一个API概述信息:
   提供可执行的示例让用户可以直接在终端里面看到API的调用情况,最大程度的让这些示例可以简单的使用,以减少用户尝试使用API的工作量。例如:
   如果你使用   prmd   生成Markdown文档,每个节点都会自动获取一些示例。
   描述您的API的稳定性或是它在各种各样节点环境中的完备性和稳定性,例如:加上原型版(prototype)/开发版(development)/产品版(production)等标记。
   更多关于可能的稳定性和改变管理的方式,查看 ** **Heroku API compatibility policy 
   一旦你的API宣布产品正式版本及稳定版本时,不要在当前API版本中做一些不兼容的改变。如果你需要,请创建一个新的版本的API。

API 设计规范

2. API接口入门(一):读懂API接口文档

本文目录: 
  
 API接口是什么?
  
 为什么我们需要API接口?
  
 API接口的核心
  
 一、API接口是什么?
  
 我们来以一个常见的数学公式理解API,比如y=x+2,当x=2的时候,y=4,对么?
  
 那此时,我们把y=x+2称为接口,x=2称为参数,y=4称为返回结果,那这个接口的功能就是能把我们输入的数加上2(注意:这里你可以发现接口自身是带有逻辑的)。
                                          
 类比地,我们来理解一个常见的场景,比如现在有一个可以把经纬度转化为城市的接口,那当我输入经度是55°,纬度是88°的时候,接口通过自己的逻辑运算,返回结果告诉我:杭州市。
  
 这样你就可以清晰地了解百度百科的官方解释了,接口就是预先定义的函数逻辑,他是供其他系统请求,然后返回结果的一个东西。
  
 二、为什么我们需要API接口?
  
 背景:我们的业务系统涉及多方多面,如果要一个公司或者一个系统把所有业务都做完,那未免工作量太大了吧?并且如果其他系统或公司有更好的运算逻辑,那我们在设计功能的时候可以考虑利用接口进行开发。
  
 核心需求:利用现有接口可以降低开发成本,缩短开发成本。
  
 举个例子:比如我是打车的APP,现在我需要在我的页面上展现地图的功能,对于我司而言,新做地图功能未免成本过高,那我们可以在高德开放平台或者百度地图的开放平台,找到地图API,这样的话我们只需要购买高德的服务,部署调用高德地图API,这样就可以快速在我们页面上线地图功能了。
                                          
 三、API接口的核心
  
 对于小白而言,初看API文档可能是一头雾水的——从哪里看,怎么看,看什么是摆在面前的问题。
  
 其实对于产品经理而言,我们应该更关注这个公司可以提供什么样的API接口服务,比如我知道高德可以提供地图API,规划路线的API,这样的话在我们设计功能和工作中就可以想到调用他们的服务或者参考。
  
 所以产品小白们看不懂也不用过于担心,未来工作中你也会更深入了解清楚,因为看懂并不复杂,以下是API接口的核心点,所有的说明文档离不开这5个核心点。
  
 以下说明均以微信开放平台为例说明,文末有各开放平台的地址,大家有空可以去学习。好了,事不宜迟,现在我们来建立一个场景。
  
 我们现在有一个APP,需要用户在购买的时候调起微信支付的API,完成购买。请各位自动进入这个场景,把自己当作一位产品经理。
  
 1. 接口地址
  
 现在Now,用户点击付款,我们需要告诉微信,我们要调起你们的收银台啦!但,去哪里告诉呢?这就需要接口地址了,也就相当于向微信的这条链接传输指定的数据。
  
 一个链接地址不是我们理解的一个页面,你可以理解是一个电话号码,小白们要改变这个观念。
  
 此时我们可以看到接口文档告诉我们链接是如下这条,那我们现在已经拨通微信的电话了。
                                          
 2. 请求参数(报文)
  
 我们现在需要告诉微信,你想调用收银台对吧。那我们需要写下来,此时生成的叫做报文,也就是你想告诉这个接口的内容是什么?相当于前文函数的输入x=2。
  
 一般来说,报文的格式和内容都是按接口文档规定的。如下文就是微信开放平台对调起收银台的报文要求。
                                          
 我们先来看前2个参数,你现在跟微信在对话,是不是应该先告诉微信,你是谁?这里微信的文档告诉你应该要用应用ID+商户号来确定你的身份,什么意思呢?
  
 比如你是A商户,下面有a,b,c三个APP,所以微信要知道你是哪个商家,下面的哪个APP要用收银台。这是非常重要的,微信后面要把收到的钱打到对应的账户以及统计数据等。
  
 那我们就在报文里面写下这两句话:
  
 wx2421b1c4370ec43b(我的应用ID是wx2421…….)
  
 10000100(我的商户号是10000…….)
  
 好了,现在微信知道你是谁了,那你要告诉微信,你需要微信支付帮你收多少钱对吧?这里定义了货币类型和总金额,也就是收什么货币,收多少钱。
                                          
 这里你看,货币类型的必填写了否,也就是说你也可以不告诉微信支付货币类型是什么,因为他在后面备注了默认是人民币。
  
 好的,那我们写下两段报文
  
 CNY(我要收人民币)
  
 1(我要收1元)
                                          
 好了,现在微信知道你是谁,也知道要收多少钱了,那接下来微信支付要把收钱结果告诉你呀,因为你得知道用户是成功支付了才能继续发货,服务啊等等的。所以这里我们用到通知地址,就是告诉微信,等下完事了他去哪里告诉你支付结果。那我们把地址写好:
  
 http://wxpay.wxutil.com/pub_v2/pay/notify.v2.php
  
 3. 返回结果
  
 刚刚微信支付已经去收款了,现在他要在我们留下的通知地址中,告诉我们结果了。结果无非是两种:成功收款?收款不成功?
  
  (1)成功 
  
 很顺利,现在用户成功付钱了,并且微信也把成功的消息告诉我们了,并且他还把用户支付的一些信息也告诉我们。
  
 那这里就是微信支付成功收款后告诉我们的信息。
                                          
 应用APPID,商户号:告诉你我成功扣款的是哪家商户的哪个APPID的交易。
  
 业务结果:成功或失败
  
  (2)失败 
  
 在产品设计的时候,我们往往很关注失败的情况,当收款失败的时候,微信同时会告诉你失败的原因,如下图很好理解,失败的原因有很多很多种,我们在设计的时候往往要分析每种失败的原因,为每个失败的原因设计页面和用户提示,以确保用户能理解。
                                          
 以上就是API接口基本运作模式的理解,下面我将继续更新API接口的一些更为深入和细节的关键元素,如请求方式/签名/加解密等等。
  
 可供参考的开放平台网站
  
 微信支付:https://pay.weixin.qq.com/wiki/doc/api/index.html
  
 高德平台开放平台:https://lbs.amap.com/

3. API标准有那些

具体如下:
一、标准共分三大类:
1.石油设备设计及制造规范;
2.石油设备使用及维护推荐做法;
3.钻井及采油作业推荐做法。
目前,API公布了已用于API产品认证的54项产品规范。
二、API标准化政策
美国石油学会规范的出版,有利于采购标准化的材料和设备,同时也是为了制造商生产符合本会相应规范的材料或设备提供指导。这些规范不是旨在排队优良技术的需求,也不以任何方式阻碍任何人购买生产符合其它规范的产品。制定、发布API规范和API质量纲要规范,绝非旨在限制买主向未授权使用API会标的制造商购买产品。
API规范可供愿意执行规范的所有人使用。本会已做出不懈的努力,以保证其规范数据的准确性和可靠性。但是,本会对出版任何一个API规范都不表态担保和保证,并声明:凡因使用API规范而造成的损失或损坏所引起的责任和义务,API均不予以承担。
凡在自己生产的设备或材料上标有某一API规范的制造商,均有责任遵守该规范的全部条款。但API对其产品是否确实符合相应的API规范不作任何表态、担保和保证。
三、API认证介绍
1.API会标API会标是美国石油学会的学会标志。该标志经美国注册登记,未经许可任何人不得使用。
2.API取证API取证即通过一个申请、检查、确认程序,有API向产品技术商符合API产品规范、质量保证体系符合API质量纲要规范的制造厂授予证书,允许制造厂在其产品上使用API会标标志。API取证的实质是商标转让使用的授权活动。
3.API对会标的说明
(1)只授予通过API认证的制造厂
(2)不是对制造厂的担保
(3)不是对设计的赞同
(4)不是对产品的担保
(5)制造厂保证经确认的产品,每一个都符合制造时的API规范
(6)API承认制造厂在遵守制定的API标准方面受到了API的信任
四、API认证的需求
API认证从过去的潜在需求,在加入WTO的进程中,变为了显在的需求,石油机械产品的定货中,越来越注重API产品的质量认可,是由于API在石油行业的特殊地位所决定。API在美国国内及国外都享有很高的声望,它所制定的石油化工和采油机械技术标准被许多国家采用,它是美国商业部和美国贸易委员会承认的石油机械认证机构。API的认证标志在国际上也享有很高的信誉。佩带API标志的石油机械不仅被认为是质量可靠而具有先进水平,当然,价格也较高。
企业普遍反映API认证的费用太高。确实,就算是在欧美发达国家,认证也是一笔较高的投入。从很现实的角度来看,认证的费用最终是由购买者承担,企业在认证上的投入实际上应视为是产品附加值提高的技术成本投入。
中东、南美和亚洲许多国家的石油公司在招标采购石油机械时,一般都要求佩有API标志的产品才能有资格参加投标。
API对申请认证的产品不要求强制性的实验室检测,但对涉及石油、天然气的采集、加工行业的各种设备,API提出了55种详细规范。如,6D规范涉及管线阀门,包括球阀、闸阀、止回阀等。这些规范规定了产品需满足的最低要求。虽然无强制检测,但API的观察员会检查厂家递交的产品计划书,确保厂方在生产过程中执行产品规范体系。

API标准有那些

4. API标准有那些?

具体如下:
一、标准共分三大类:
1.石油设备设计及制造规范;
2.石油设备使用及维护推荐做法;
3.钻井及采油作业推荐做法。
目前,API公布了已用于API产品认证的54项产品规范。
二、API标准化政策
美国石油学会规范的出版,有利于采购标准化的材料和设备,同时也是为了制造商生产符合本会相应规范的材料或设备提供指导。这些规范不是旨在排队优良技术的需求,也不以任何方式阻碍任何人购买生产符合其它规范的产品。制定、发布API规范和API质量纲要规范,绝非旨在限制买主向未授权使用API会标的制造商购买产品。
API规范可供愿意执行规范的所有人使用。本会已做出不懈的努力,以保证其规范数据的准确性和可靠性。但是,本会对出版任何一个API规范都不表态担保和保证,并声明:凡因使用API规范而造成的损失或损坏所引起的责任和义务,API均不予以承担。
凡在自己生产的设备或材料上标有某一API规范的制造商,均有责任遵守该规范的全部条款。但API对其产品是否确实符合相应的API规范不作任何表态、担保和保证。
三、API认证介绍
1.API会标API会标是美国石油学会的学会标志。该标志经美国注册登记,未经许可任何人不得使用。
2.API取证API取证即通过一个申请、检查、确认程序,有API向产品技术商符合API产品规范、质量保证体系符合API质量纲要规范的制造厂授予证书,允许制造厂在其产品上使用API会标标志。API取证的实质是商标转让使用的授权活动。
3.API对会标的说明
(1)只授予通过API认证的制造厂
(2)不是对制造厂的担保
(3)不是对设计的赞同
(4)不是对产品的担保
(5)制造厂保证经确认的产品,每一个都符合制造时的API规范
(6)API承认制造厂在遵守制定的API标准方面受到了API的信任
四、API认证的需求
API认证从过去的潜在需求,在加入WTO的进程中,变为了显在的需求,石油机械产品的定货中,越来越注重API产品的质量认可,是由于API在石油行业的特殊地位所决定。API在美国国内及国外都享有很高的声望,它所制定的石油化工和采油机械技术标准被许多国家采用,它是美国商业部和美国贸易委员会承认的石油机械认证机构。API的认证标志在国际上也享有很高的信誉。佩带API标志的石油机械不仅被认为是质量可靠而具有先进水平,当然,价格也较高。
企业普遍反映API认证的费用太高。确实,就算是在欧美发达国家,认证也是一笔较高的投入。从很现实的角度来看,认证的费用最终是由购买者承担,企业在认证上的投入实际上应视为是产品附加值提高的技术成本投入。
中东、南美和亚洲许多国家的石油公司在招标采购石油机械时,一般都要求佩有API标志的产品才能有资格参加投标。
API对申请认证的产品不要求强制性的实验室检测,但对涉及石油、天然气的采集、加工行业的各种设备,API提出了55种详细规范。如,6D规范涉及管线阀门,包括球阀、闸阀、止回阀等。这些规范规定了产品需满足的最低要求。虽然无强制检测,但API的观察员会检查厂家递交的产品计划书,确保厂方在生产过程中执行产品规范体系。

5. API标准的介绍

API标准主要是规定设备性能,有时也包括设计和工艺规范,标准制定领域包括石油生产、炼油、测量、运输、销售、安全和防火、环境规程等,其信息技术标准包括石油和天然气工业用EDI、通信和信息技术应用等方面。
API的一项重要任务就是负责石油和天然气工业用设备的标准化工作,以确保该工业界所用设备的安全、可靠和互换性。
API是美国石油学会(AmericanPetroleumInstitute)的英文缩写。API建于1919年,是美国第一家国家级的商业协会,也是全世界范围内最早、最成功的制定标准的商会之一。
/iknow-pic.cdn.bcebos.com/9d82d158ccbf6c81fbaf3843b23eb13532fa4084"target="_blank"title="点击查看大图"class="ikqb_img_alink">/iknow-pic.cdn.bcebos.com/9d82d158ccbf6c81fbaf3843b23eb13532fa4084?x-bce-process=image%2Fresize%2Cm_lfit%2Cw_600%2Ch_800%2Climit_1%2Fquality%2Cq_85%2Fformat%2Cf_auto"esrc="https://iknow-pic.cdn.bcebos.com/9d82d158ccbf6c81fbaf3843b23eb13532fa4084"/>
扩展资料:
从API的网上名单上看,目前国内几大知名润滑油企业都榜上有名,但这与国内号称有4000余家润滑油厂商来说,获API认证的比例很不相称。
一些国有强势润滑油企业并不缺乏获API认证的技术优势,但在API的榜上无名,他们缺少的是像民营企业那样强烈的市场化意识,对消费者心理的领悟和市场动态的快速反应,习惯按照固有的模式运行。
而那些杂牌润滑油企业都意识到API认证的价值,其产品不论好赖,统统都贴上“API认证”的标签,这样能够增加卖点,增强消费者对产品的信任感。
因此,润滑油市场上就出现了“API认证”标志满天飞、消费者难辩真假的现象。实际上,API的许多低档油标准早已升级,只要按照一定路径,登录API网址就可以了解真正获得API认证的企业名单。
从国内企业获得API认证不多的现状来看,国内企业的润滑油产品大部分集中在中低档次上,高档的不多。因为如果要进军高档油领域,就必须用API标准来衡量和评价产品品质。
因此,获得API认证的过程并不难,难的是产品的技术实力能否达到API认证的要求。
参考资料:/www.people.com.cn/GB/paper1668/10138/928602.html"target="_blank"title="人民网-冒用API认证标志是违法行为">人民网-冒用API认证标志是违法行为

API标准的介绍

6. API标准有那些?

具体如下:
一、标准共分三大类:
1.石油设备设计及制造规范;
2.石油设备使用及维护推荐做法;
3.钻井及采油作业推荐做法。
目前,API公布了已用于API产品认证的54项产品规范。
二、API标准化政策
美国石油学会规范的出版,有利于采购标准化的材料和设备,同时也是为了制造商生产符合本会相应规范的材料或设备提供指导。这些规范不是旨在排队优良技术的需求,也不以任何方式阻碍任何人购买生产符合其它规范的产品。制定、发布API规范和API质量纲要规范,绝非旨在限制买主向未授权使用API会标的制造商购买产品。
API规范可供愿意执行规范的所有人使用。本会已做出不懈的努力,以保证其规范数据的准确性和可靠性。但是,本会对出版任何一个API规范都不表态担保和保证,并声明:凡因使用API规范而造成的损失或损坏所引起的责任和义务,API均不予以承担。凡在自己生产的设备或材料上标有某一API规范的制造商,均有责任遵守该规范的全部条款。但API对其产品是否确实符合相应的API规范不作任何表态、担保和保证。
三、API认证介绍
1.API会标API会标是美国石油学会的学会标志。该标志经美国注册登记,未经许可任何人不得使用。
2.API取证API取证即通过一个申请、检查、确认程序,有API向产品技术商符合API产品规范、质量保证体系符合API质量纲要规范的制造厂授予证书,允许制造厂在其产品上使用API会标标志。API取证的实质是商标转让使用的授权活动。
3.API对会标的说明
(1)只授予通过API认证的制造厂
(2)不是对制造厂的担保
(3)不是对设计的赞同
(4)不是对产品的担保
(5)制造厂保证经确认的产品,每一个都符合制造时的API规范
(6)API承认制造厂在遵守制定的API标准方面受到了API的信任
四、API认证的需求
API认证从过去的潜在需求,在加入WTO的进程中,变为了显在的需求,石油机械产品的定货中,越来越注重API产品的质量认可,是由于API在石油行业的特殊地位所决定。API在美国国内及国外都享有很高的声望,它所制定的石油化工和采油机械技术标准被许多国家采用,它是美国商业部和美国贸易委员会承认的石油机械认证机构。API的认证标志在国际上也享有很高的信誉。佩带API标志的石油机械不仅被认为是质量可靠而具有先进水平,当然,价格也较高。企业普遍反映API认证的费用太高。确实,就算是在欧美发达国家,认证也是一笔较高的投入。从很现实的角度来看,认证的费用最终是由购买者承担,企业在认证上的投入实际上应视为是产品附加值提高的技术成本投入。
中东、南美和亚洲许多国家的石油公司在招标采购石油机械时,一般都要求佩有API标志的产品才能有资格参加投标。
API对申请认证的产品不要求强制性的实验室检测,但对涉及石油、天然气的采集、加工行业的各种设备,API提出了55种详细规范。如,6D规范涉及管线阀门,包括球阀、闸阀、止回阀等。这些规范规定了产品需满足的最低要求。虽然无强制检测,但API的观察员会检查厂家递交的产品计划书,确保厂方在生产过程中执行产品规范体系。

7. 接口标准是什么

(1)IDE和EIDE

      PC/XT和PC/AT机器使用的硬盘被称为MFM硬盘或ST-506/412硬盘,MFM(Modified Frequency Modulation)是指一种编码方案,而ST-506/412则是希捷开发的一种硬盘接口,ST-506接口不需要任何特殊的电缆及接头,但是它支持的传输速度很低,因此到了1987年左右这种接口就基本上被淘汰了。

  迈拓于1983年开发了ESDI(Enhanced Small Drive Interface)接口。这种接口把编解码器放在了硬盘本身之中,它的理论传输速度是ST-506的2~4倍。但由于成本比较高,九十年代后就逐步被淘汰掉了。

  IDE(Integrated Drive Electronics)实际上是指把控制器与盘体集成在一起的硬盘驱动器,这样减少了硬盘接口的电缆数目与长度,数据传输的可靠性得到了增强,硬盘制造起来变得更容易,对用户而言,硬盘安装起来也更为方便。IDE接口也叫ATA(Advanced Technology Attachment)接口。

  ATA接口最初是在1986年由CDC、康柏和西部数据共同开发的,他们决定使用40芯的电缆,最早的IDE硬盘大小为5英寸,容量为40MB。ATA接口从80年代末期开始逐渐取代了其它老式接口。

   80年代末期IBM发明了MR(Magneto Resistive)磁阻磁头,这种磁头在读取数据时对信号变化相当敏感,使得盘片的存储密度能够比以往的20MB/in2提高数十上百倍。1991年,IBM生产的3.5英寸硬盘0663-E12使用了MR磁头,容量首次达到了1GB,从此硬盘容量开始进入了GB数量级,直到今天,大多数硬盘仍然采用MR磁头。



   PIO模式即Programming Input/Output Model。这种模式使用PC I/O端口指令来传送所有的命令、状态和数据。由于驱动器中有多个缓冲区,对硬盘的读写一般采用I/O串操作指令,这种指令只需一次取指令就可以重复多次地完成I/O操作,因此,达到高的数据传输率是可能的。

  DMA即Direct Memory Access。它表示数据不经过CPU,而直接在硬盘和内存之间传送。在多任务操作系统内,如OS/2、Linux、Windows NT等,当磁盘传输数据时,CPU可腾出时间来做其它事情,而在DOS/Windows3.X环境里,CPU不得不等待数据传输完毕,所以在这种情况下,DMA方式的意义并不大。

  DMA方式有两种类型:第三方DMA(third-party DMA)和第一方DMA(first-party DMA)(或称总线主控DMA,Busmastering DMA)。第三方DMA通过系统主板上的DMA控制器的仲裁来获得总线和传输数据。而第一方DMA,则完全由接口卡上的逻辑电路来完成,当然这样就增加了总线主控接口的复杂性和成本。现在,所有较新的芯片组均支持总线主控DMA。

(2)SCSI接口

  (Small Computer System Interface小型计算机系统接口)是一种与ATA完全不同的接口,它不是专门为硬盘设计的,而是一种总线型的系统接口,每个SCSI总线上可以连接包括SCSI控制卡在内的8个SCSI设备。SCSI的优势在于它支持多种设备,传输速率比ATA接口快得多但价格也很高,独立的总线使得它对CPU的占用率很低。 最早的SCSI是于1979年由美国的Shugart公司(Seagate希捷公司的前身)制订的,90年代初,SCSI发展到了SCSI-2,1995年推出了SCSI-3,其俗称Ultra SCSI, 1997年推出了Ultra 2 SCSI(Fast-40),其采用了LVD(Low Voltage Differential,低电平微分)传输模式,16位的Ultra2SCSI(LVD)接口的最高传输速率可达80MB/S,允许接口电缆的最长为12米,大大增加了设备的灵活性。1998年,更高数据传输率的Ultra160/m的SCSI(Wide下的Fast-80)规格正式公布,其最高数据传输率为160MB/s,昆腾推出的Atlas10K和Atlas四代等产品支持Ultra3 SCSI的Ultra160/m传输模式。

  SCSI硬盘具备有非常优秀的传输性能。但由于大多数的主板并不内置SCSI接口,这就使得连接SCSI硬盘必须安装相应的SCSI卡,目前关于SCSI卡有三个正式标准,SCSI-1,SCSI-2和SCSI-3,以及一些中间版本,要使SCSI硬盘获得最佳性能就必须保证SCSI卡与SCSI硬盘版本一致(目前较新生产的SCSI硬盘和SCSI卡都是向前兼容的,不一定必须版本一致)。

  (3)IEEE1394:IEEE1394又称为Firewire(火线)或P1394,它是一种高速串行总线,现有的IEEE1394标准支持100Mbps、200Mbps和400Mbps的传输速率,将来会达到800Mbps、1600Mbps、3200Mbps甚至更高,如此高的速率使得它可以作为硬盘、DVD、CD-ROM等大容量存储设备的接口。IEEE1394将来有望取代现有的SCSI总线和IDE接口,但是由于成本较高和技术上还不够成熟等原因,目前仍然只有少量使用IEEE1394接口的产品,硬盘就更少了。

接口标准是什么

8. API标准?

API标准--API是美国石油学会(American Petroleum Institute)的英文缩写。API建于1919年,是美国第一家国家级的商业协会,也是全世界范围内最早、最成功的制定标准的商会之一。 
  API背景介绍   API的一项重要任务,就是负责石油和天然气工业用设备的标准化工作,以确保该工业界所用设备的安全、可靠和互换性。制定协调标准是API最早和最成功的项目之一,自1924年发布第1个标准开始,API现在已发布了500个标准。API是ANSI认可的标准制定机构,其标准制定遵循ANSI的协调和制定程序准则,API还与ASTM联合制定和出版标准,此外,API积极参加适合全球工业的ISO标准的制定工作,是ISO/TC 671SC9井口设备和管线阀门的秘书处。   API标准应用广泛,不仅在国内被企业采用和被美国联邦和州法律法规以及运输部、国防部、职业安全与健康管理局、美国海关、环境保护署、美国地质勘查局等政府机构引用,而且也在世界范围内被ISO、国际法制计量组织和100多个国家标准所引用。   API标准主要是规定设备性能,有时也包括设计和工艺规范,标准制定领域包括石油生产、炼油、测量、运输、销售、安全和防火、环境规程等,其信息技术标准包括石油和天然气工业用EDI、通信和信息技术应用等方面。   API在美国国内以及在世界其他国家都享有很高的声望,它是美国商业部和美国贸易委员会承认的石油机械认证机构。它所制定的石油化工和采油机械技术标准被许多国家采用,中东、南美和亚洲许多国家的石油公司在招标采购石油机械时,一般都要求佩有API标志的产品才能有资格参加投标。因此,拥有API标志的石油机械设备不仅被认为是质量可靠而且具有先进水平。目前,在包括勘探和生产、运输、精炼和市场营销等各个方面拥有来自全世界的会员。今天,API已发展成为不仅在美国,而且越来越多地成为世界石油工业活动的有机组成部分。   API标志及其使用权   API会标是美国石油学会的学会产品标志,始于1924年,目的是为了鉴定生产的设备、材料,并提供能符合API质量体系和产品标准的生产企业。该标志经美国注册登记,未经许可任何人不得使用。   API取证即通过一个申请、检查、确认程序,有API向产品技术商符合API产品规范、质量管理体系(ISO9001)符合API质量纲要规范的制造厂授予证书,允许制造厂在其产品上使用API会标标志。API取证的实质是商标转让使用的授权活动。