跳至内容
公云(PubYun)wiki
用户工具
注册
登录
站点工具
工具
显示页面
修订记录
反向链接
最近更改
媒体管理器
网站地图
登录
注册
最近更改
媒体管理器
网站地图
您的足迹:
帮助:api
本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。
====== å°è¾£æ¤ï¼3322ï¼å¨æååæ´æ°API ====== éè¿å°è¾£æ¤APIï¼æ¨å¯ä»¥å¾å®¹æå¼ååºå¨æåå客æ·ç«¯ï¼æè å°å¨æåååè½éæå°èªå·±ç设å¤ä¸ã ä»»ä½å°è¾£æ¤çè´¦æ·ï¼é½å¯ä»¥ä½¿ç¨å¨æååAPIï¼å¦ææ¨è¿æ²¡ææ³¨åå°è¾£æ¤ï¼è¯·[[http://www.3322.net/accounts/signup/|ç¹æ¤]]注åã ===== ä»ç» ===== * Clientç请æ±åºè¯¥ä½¿ç¨HTTP/1.0以ä¸åè®®ï¼Serverçååºä¸å®ä¸ºHTTP/1.0 * Client å Server,éè¿ HTTP GET æ HTTP POST 请æ±è¿è¡äº¤äºã * éè¦äºå¡å¤çï¼Clientåé宿´ç请æ±ï¼å¹¶ä¸è§£ææå¡å¨ç«¯çç¸åºï¼ä¿è¯ååæ´æ°çæåã * å¦æè¯·æ±å¤±è´¥ï¼åéè¦å»¶æ¶ä¸æ®µæ¶é´ï¼æ¨è1åéï¼è¿è¡éè¯ï¼ç´å°ååæ´æ°æåã * æ´æ°è¯·æ±ç触åï¼æä¸¤ç§æ¹å¼ï¼ äºä»¶é©±å¨ï¼å®¢æ·ç«¯ä¾¦å¬ç³»ç»çIP请æ±ååäºä»¶ï¼ä¸æ¦æ¹åäºIPï¼ç«å³åèµ·æ´æ°è¯·æ±ï¼æ¨èè¿ç§æ¹å¼ï¼æ´æ°æ²¡æå»¶æ¶ã 宿¶æ´æ°ï¼æ¯éä¸å®æ¶é´ï¼åèµ·æ´æ°è¯·æ±ï¼æ³¨æä¸¤æ¬¡é´éæ¶é´ä¸è½çäº1åéï¼æ¶è´¹ç¨æ·ä¸è½çäº15ç§ï¼ï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥ååä¼è¢«ç³»ç»èªå¨å°å µï¼è¿å abuse 代ç ã * IPçå忣æµï¼å¯ä»¥éç¨ web æ¹å¼è¿è¡æ£æµï¼å®¢æ·ç«¯å¯ä»¥è®¿é® http://ip.3322.net è·åèªå·±çIPï¼ä¸¤æ¬¡è¯·æ±è¿åçIPååäºï¼å°±åèµ·æ´æ°è¯·æ±ã注æè®¿é® http://ip.3322.net ç两次é´éæ¶é´ä¸è½çäº1åéï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥IPä¼è¢«ç³»ç»èªå¨å°å µ * 使ç¨[[http://www.ietf.org/rfc/rfc2617.txt|HTTP]]éªè¯ä½ä¸ºAPIçç¨æ·èº«ä»½éªè¯æ¹å¼ã * User-Agent, 代表客æ·ç«¯åç§°ãçæ¬ï¼éè¦æ ¹æ®è®¾å¤ç±»åãåç§°ãç¹å¾è¿è¡èªå®ä¹ï¼ä¸è¬å æ¬è®¾å¤çåå®¶ãåå·ãfirmwareçæ¬å·ã请ä¸è¦ä½¿ç¨ç¤ºèä¸çåç§°ï¼å¦åå¯è½è¢«å°å µã ===== 卿ååæ´æ°æ¥å£ ===== ==== æ¥å£å°å ==== **API URL** <code> http://members.3322.net/dyndns/update </code> **HTTP请æ±** <code> GET /dyndns/update?hostname=yourhost.ourdomain.ext&myip=ipaddress&wildcard=OFF&mx=mail.exchanger.ext&backmx=NO&offline=NO HTTP/1.1 Host: members.3322.net Authorization: Basic username:password User-Agent: myclient/1.0 me@null.net </code> ==== åæ°è¯´æ ==== * username:password è¯¥åæ°å¿ é, ç¨æ·ååå¯ç ç¨æ¥è¿è¡èº«ä»½è®¤è¯ï¼å¿ é¡»ä½¿ç¨ base64è¿è¡ç¼ç * hostname=host.3322.org è¯¥åæ°å¿ é, éè¦æ´æ°çåå * myip=ipaddr è¯¥åæ°å¯é, åå对åºçIPã妿䏿å®ï¼åæå¡å¨å°éæ©æä½³çIP(ä¸äºProxyä¼ä¼ é客æ·ç«¯çIP, è¿ä¼è¢«æå¡å¨æ£æµå°)ãå¦æä¼ éçå°åæ ¼å¼é误ï¼å忽ç¥è¿ä¸ªåæ°ï¼èç¨æå¡å¨æ£æµ å°çIPã * wildcard=ON|OFF è¯¥åæ°å¯é, è¯¥åæ°å¯éï¼æ¯å¦æ¯ææ³åå(éé 符)ï¼ç¼ºç为OFFãONæä¸ºç *.host.3322.orgçåäºhost.3322.org * mx=mailexchanger è¯¥åæ°å¯é, ææMail eXchangerãå¿ é¡»è½å¤è§£æå°ä¸ä¸ªIPï¼å¦å被忽ç¥ã妿䏿ä¾è¯¥åæ°æè ä¸è½è§£æå°ä¸ä¸ªIPï¼mxè®°å½ä¼è¢«å é¤ã * backmx=YES|NO è¯¥åæ°å¯é, ææåé¢çmxåæ°ä¼è¢«è®¾ç½®æå¤ä»½é®ä»¶æå¡å¨ï¼å³é®ä»¶ä¼é¦å åéå°ä½ çæºå¨ä¸ï¼å¦æ 䏿åï¼æä¼åéå°å¤ä»½é®ä»¶æå¡å¨ä¸ã * offline=YES|NO Optional: Yes è¯¥åæ°å¯é, 使ååææ¶å¤±æã ==== HTTPç¶æè¿åç ==== HTTPç¶æè¿åç 为200ã4XXã5XXï¼å ¶ä¸4XX表示认è¯é误ï¼500表示æå¡å¨å é¨åºéï¼200表示æ£å¸¸è¯·æ±ã使¯å¨æåå客æ·ç«¯ 请忽ç¥HTTPè¿åç ï¼èæ¯å¯¹ä¸é¢çè¿åå¼è¿è¡è§£æãæ¯å¦è¿åå¼"interror"表示å é¨åºéï¼è¿æ¶å¯¹åºçHTTPç¶æè¿åç æ¯500ã ==== è¿åå¼ ==== === æ´æ°æå === * good æåï¼IPå°åå·²ç»æåæ´æ°ï¼good åé¢ä¼è·çææ´æ°çIPå°å * nochg æåï¼IPå°åå䏿¬¡è¯·æ±æ²¡æåå, nochg åé¢ä¼è·çæè¯·æ±çIPå°å === æ´æ°åºé === * badauth 身份认è¯åºéï¼è¯·æ£æ¥ç¨æ·ååå¯ç , æè ç¼ç æ¹å¼åºéã * badsys 该åå䏿¯å¨æååï¼å¯è½æ¯å ¶ä»ç±»åçååï¼æºè½ååãéæååãåå转åãåååï¼ã * badagent ç±äºåé大éå徿°æ®ï¼å®¢æ·ç«¯å称被系ç»å°æã === åæ°åºé === * notfqdn 没ææä¾åååæ°ï¼å¿ é¡»æä¾ä¸ä¸ªå¨å°è¾£æ¤æ³¨åç卿ååååã * nohost ååä¸åå¨ï¼è¯·æ£æ¥å忝å¦å¡«åæ£ç¡®ã * !donator å¿ é¡»æ¯æ¶è´¹ç¨æ·ï¼æè½ä½¿ç¨ offline 离线åè½ã * !yours 该åååå¨ï¼ä½æ¯ä¸æ¯è¯¥ç¨æ·ææã * !active 该åå被系ç»å ³éï¼è¯·èç³»å°è¾£æ¤å®¢æäººåã * abuse 该ååç±äºæ®µæ¶é´å¤§éåéæ´æ°è¯·æ±ï¼è¢«ç³»ç»ç¦æ¢ï¼è¯·èç³»å°è¾£æ¤å®¢æäººåã === æå¡å¨åºé === * dnserr DNS æå¡å¨æ´æ°å¤±è´¥ã * interror æå¡å¨å é¨ä¸¥ééè¯¯ï¼æ¯å¦æ°æ®åºåºéæè DNSæå¡å¨åºéã ===== è·åIPæ¥å£ ===== 客æ·ç«¯å¯ä»¥éè¿è¯¥æ¥å£è·åèªå·±çIPï¼ç¨äºå®¢æ·ç«¯æ£æµIPçååã æ³¨æè®¿é® http://ip.3322.net ç两次é´éæ¶é´ä¸è½çäº1åéï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥IPä¼è¢«ç³»ç»èªå¨å°å µ ==== æ¥å£å°å ==== **API URL** <code> http://ip.3322.net </code> ==== åæ°è¯´æ ==== æ ==== è¿åå¼ ==== 客æ·ç«¯çIPå°å ===== 常è§é®é¢ ===== * 没æå¯¹è¯·æ±åäºå¡å¤çï¼æ²¡ææ£æ¥æå¡å¨çè¿åå¼ï¼æ²¡æå¤æååæ´æ°æ¯å¦æå * æ´æ°å¤±è´¥ä»¥åï¼æ²¡æè®°å½æ¥å¿ï¼æ²¡æè¿è¡å»¶æ¶ãéè¯çè¿ç¨ * 请æ±è¿äºé¢ç¹ï¼å¯¼è´åå被æå¡å¨å°æ * 客æ·ç«¯ä½¿ç¨å®ä¾çååï¼æ²¡ææ ¹æ®èªå·±è®¾å¤çç±»åãåç§°ãç¹å¾è¿è¡èªå®ä¹ ===== 设å¤è®¤è¯ ===== å°è¾£æ¤å¨æååæ´æ°APIç®åæç¨ï¼æ¹ä¾¿äºå¼åè åéæåå¼åèªå·±ç客æ·ç«¯ï¼ç»è®¾å¤å¢å 卿åååè½ã 使¯å¦æå¯¹å®¢æ·ç«¯ççè§£ä¸æ·±å ¥ï¼ä¼äº§çä¸äºé误æè æ´æ°å¤±è´¥ï¼å¯¼è´å¨æååæ´æ°å¤±è´¥ï¼ç¨æ·æ æ³éè¿åå访é®è®¾å¤ã å°è¾£æ¤ä¸ºäºè§èååçæ´æ°æµç¨ï¼ä¿é设å¤çæ£å¸¸å·¥ä½ï¼å¯¹å¸åºä¸ä½¿ç¨å°è¾£æ¤å¨æååæ´æ°APIç设å¤è¿è¡è®¤è¯ï¼ * ç±å°è¾£æ¤çå·¥ç¨å¸ï¼å¯¹è®¾å¤è¿è¡è®¤çï¼å ¨é¢çæµè¯ï¼ä¿è¯è®¾å¤è½å¤å¨åç§ç½ç»æ¡ä»¶ãåç§å¼å¸¸æ¡ä»¶ä¸æ£å¸¸æ´æ°åå * æä¾è®¤è¯çè®¾å¤æ¸ åï¼æ¨èå°è¾£æ¤çå¹¿å¤§ç¨æ·éç¨ è®¾å¤è®¤è¯çå ·ä½æ¹æ³ï¼è¯·åè§[[帮å©:设å¤è®¤è¯|设å¤è®¤è¯]]
帮助/api.1355892888.txt.gz
· 最后更改: 2012/12/19 12:54 由
refactor
页面工具
显示页面
修订记录
反向链接
回到顶部