这里会显示出您选择的修订版和当前版本之间的差别。
后一修订版 | 前一修订版 | ||
帮助:api [2011/08/04 21:37] refactor 创建 |
帮助:api [2013/03/04 13:22] refactor [设备认证] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== å°è¾£æ¤å¨æååæ´æ°API ====== | + | ====== å ¬äº(3322ï¼å¨æååæ´æ°API ====== |
- | éè¿å°è¾£æ¤APIï¼æ¨å¯ä»¥å¾å®¹æå¼ååºå¨æåå客æ·ç«¯ï¼æè å°å¨æåååè½éæå°èªå·±ç设å¤ä¸ã | + | éè¿å ¬äºAPIï¼æ¨å¯ä»¥å¾å®¹æå¼ååºå¨æåå客æ·ç«¯ï¼æè å°å¨æåååè½éæå°èªå·±ç设å¤ä¸ã |
- | + | ||
- | ä»»ä½å°è¾£æ¤çè´¦æ·ï¼é½å¯ä»¥ä½¿ç¨å¨æååAPIï¼å¦ææ¨è¿æ²¡ææ³¨åå°è¾£æ¤ï¼è¯·[[http://www.3322.net/accounts/signup/|ç¹æ¤]]注åã | + | |
+ | ä»»ä½å ¬äºçè´¦æ·ï¼é½å¯ä»¥ä½¿ç¨å¨æååAPIï¼å¦ææ¨è¿æ²¡ææ³¨åå ¬äºï¼è¯·[[http://www.3322.net/accounts/signup/|ç¹æ¤]]注åã | ||
===== ä»ç» ===== | ===== ä»ç» ===== | ||
行 22: | 行 21: | ||
宿¶æ´æ°ï¼æ¯éä¸å®æ¶é´ï¼åèµ·æ´æ°è¯·æ±ï¼æ³¨æä¸¤æ¬¡é´éæ¶é´ä¸è½çäº1åéï¼æ¶è´¹ç¨æ·ä¸è½çäº15ç§ï¼ï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥ååä¼è¢«ç³»ç»èªå¨å°å µï¼è¿å abuse 代ç ã | 宿¶æ´æ°ï¼æ¯éä¸å®æ¶é´ï¼åèµ·æ´æ°è¯·æ±ï¼æ³¨æä¸¤æ¬¡é´éæ¶é´ä¸è½çäº1åéï¼æ¶è´¹ç¨æ·ä¸è½çäº15ç§ï¼ï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥ååä¼è¢«ç³»ç»èªå¨å°å µï¼è¿å abuse 代ç ã | ||
- | * IPçå忣æµï¼å¯ä»¥éç¨ web æ¹å¼è¿è¡æ£æµï¼å®¢æ·ç«¯å¯ä»¥è®¿é® http://ip.3322.net è·åèªå·±çIPï¼ä¸¤æ¬¡è¯·æ±è¿åçIPååäºï¼å°±åèµ·æ´æ°è¯·æ±ã注æè®¿é® http://ip.3322.net ç两次é´éæ¶é´ä¸è½çäº1åéï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥ååä¼è¢«ç³»ç»èªå¨å°å µ | + | * IPçå忣æµï¼å¯ä»¥éç¨ web æ¹å¼è¿è¡æ£æµï¼å®¢æ·ç«¯å¯ä»¥è®¿é® http://ip.3322.net è·åèªå·±çIPï¼ä¸¤æ¬¡è¯·æ±è¿åçIPååäºï¼å°±åèµ·æ´æ°è¯·æ±ã注æè®¿é® http://ip.3322.net ç两次é´éæ¶é´ä¸è½çäº1åéï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥IPä¼è¢«ç³»ç»èªå¨å°å µ |
* 使ç¨[[http://www.ietf.org/rfc/rfc2617.txt|HTTP]]éªè¯ä½ä¸ºAPIçç¨æ·èº«ä»½éªè¯æ¹å¼ã | * 使ç¨[[http://www.ietf.org/rfc/rfc2617.txt|HTTP]]éªè¯ä½ä¸ºAPIçç¨æ·èº«ä»½éªè¯æ¹å¼ã | ||
- | * User-Agent, 代表客æ·ç«¯åç§°ãçæ¬ï¼éè¦æ ¹æ®è®¾å¤ç±»åãåç§°ãç¹å¾è¿è¡èªå®ä¹ï¼ä¸è¦ä½¿ç¨ç¤ºèä¸çåç§°ï¼å¦åå¯è½è¢«å°å µ | + | * User-Agent, 代表客æ·ç«¯åç§°ãçæ¬ï¼éè¦æ ¹æ®è®¾å¤ç±»åãåç§°ãç¹å¾è¿è¡èªå®ä¹ï¼ä¸è¬å æ¬è®¾å¤çåå®¶ãåå·ãfirmwareçæ¬å·ã请ä¸è¦ä½¿ç¨ç¤ºèä¸çåç§°ï¼å¦åå¯è½è¢«å°å µã |
- | ===== 卿ååæ´æ°åè®® ===== | + | ===== 卿ååæ´æ°æ¥å£ ===== |
- | ==== HTTPè¯·æ± ==== | + | ==== æ¥å£å°å ==== |
+ | |||
+ | **API URL** | ||
+ | |||
+ | <code> | ||
+ | http://members.3322.net/dyndns/update | ||
+ | </code> | ||
+ | |||
+ | **HTTP请æ±** | ||
<code> | <code> | ||
GET /dyndns/update?hostname=yourhost.ourdomain.ext&myip=ipaddress&wildcard=OFF&mx=mail.exchanger.ext&backmx=NO&offline=NO HTTP/1.1 | 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.org | + | Host: members.3322.net |
Authorization: Basic username:password | Authorization: Basic username:password | ||
User-Agent: myclient/1.0 me@null.net | User-Agent: myclient/1.0 me@null.net | ||
行 67: | 行 74: | ||
è¯¥åæ°å¯é, 使ååææ¶å¤±æã | è¯¥åæ°å¯é, 使ååææ¶å¤±æã | ||
+ | ==== HTTPç¶æè¿åç ==== | ||
+ | HTTPç¶æè¿åç 为200ã4XXã5XXï¼å ¶ä¸4XX表示认è¯é误ï¼500表示æå¡å¨å é¨åºéï¼200表示æ£å¸¸è¯·æ±ã使¯å¨æåå客æ·ç«¯ | ||
+ | 请忽ç¥HTTPè¿åç ï¼èæ¯å¯¹ä¸é¢çè¿åå¼è¿è¡è§£æãæ¯å¦è¿åå¼"interror"表示å é¨åºéï¼è¿æ¶å¯¹åºçHTTPç¶æè¿åç æ¯500ã | ||
==== è¿åå¼ ==== | ==== è¿åå¼ ==== | ||
行 93: | 行 103: | ||
* notfqdn | * notfqdn | ||
- | 没ææä¾åååæ°ï¼å¿ é¡»æä¾ä¸ä¸ªå¨å°è¾£æ¤æ³¨åç卿ååååã | + | 没ææä¾åååæ°ï¼å¿ é¡»æä¾ä¸ä¸ªå¨å ¬äºæ³¨åç卿ååååã |
* nohost | * nohost | ||
行 105: | 行 115: | ||
* !active | * !active | ||
- | 该åå被系ç»å ³éï¼è¯·èç³»å°è¾£æ¤å®¢æäººåã | + | 该åå被系ç»å ³éï¼è¯·èç³»å ¬äºå®¢æäººåã |
* abuse | * abuse | ||
- | 该ååç±äºæ®µæ¶é´å¤§éåéæ´æ°è¯·æ±ï¼è¢«ç³»ç»ç¦æ¢ï¼è¯·èç³»å°è¾£æ¤å®¢æäººåã | + | 该ååç±äºæ®µæ¶é´å¤§éåéæ´æ°è¯·æ±ï¼è¢«ç³»ç»ç¦æ¢ï¼è¯·èç³»å ¬äºå®¢æäººåã |
+ | |||
+ | === æå¡å¨åºé === | ||
* dnserr | * dnserr | ||
- | DNS æå¡å¨æ´æ°å¤±è´¥ | + | DNS æå¡å¨æ´æ°å¤±è´¥ã |
+ | |||
+ | * interror | ||
+ | æå¡å¨å é¨ä¸¥ééè¯¯ï¼æ¯å¦æ°æ®åºåºéæè DNSæå¡å¨åºéã | ||
+ | |||
+ | ===== è·åIPæ¥å£ ===== | ||
+ | |||
+ | |||
+ | 客æ·ç«¯å¯ä»¥éè¿è¯¥æ¥å£è·åèªå·±çIPï¼ç¨äºå®¢æ·ç«¯æ£æµIPçååã | ||
+ | |||
+ | 注æè®¿é® http://ip.3322.net ç两次é´éæ¶é´ä¸è½çäº1åéï¼å¦æè¿ç»3次以ä¸é¢ç¹è¯·æ±ï¼è¯¥IPä¼è¢«ç³»ç»èªå¨å°å µ | ||
+ | |||
+ | |||
+ | ==== æ¥å£å°å ==== | ||
+ | |||
+ | **API URL** | ||
+ | |||
+ | <code> | ||
+ | http://ip.3322.net | ||
+ | </code> | ||
+ | |||
+ | ==== åæ°è¯´æ ==== | ||
+ | æ | ||
+ | |||
+ | ==== è¿åå¼ ==== | ||
+ | |||
+ | 客æ·ç«¯çIPå°å | ||
+ | |||
+ | |||
+ | ===== 常è§é®é¢ ===== | ||
+ | |||
+ | * 没æå¯¹è¯·æ±åäºå¡å¤çï¼æ²¡ææ£æ¥æå¡å¨çè¿åå¼ï¼æ²¡æå¤æååæ´æ°æ¯å¦æå | ||
+ | * æ´æ°å¤±è´¥ä»¥åï¼æ²¡æè®°å½æ¥å¿ï¼æ²¡æè¿è¡å»¶æ¶ãéè¯çè¿ç¨ | ||
+ | * 请æ±è¿äºé¢ç¹ï¼å¯¼è´åå被æå¡å¨å°æ | ||
+ | * 客æ·ç«¯ä½¿ç¨å®ä¾çååï¼æ²¡ææ ¹æ®èªå·±è®¾å¤çç±»åãåç§°ãç¹å¾è¿è¡èªå®ä¹ | ||
+ | |||
+ | |||
+ | ===== 设å¤è®¤è¯ ===== | ||
+ | |||
+ | |||
+ | å ¬äº(3322)卿ååæ´æ°APIç®åæç¨ï¼æ¹ä¾¿äºå¼åè åéæåå¼åèªå·±ç客æ·ç«¯ï¼ç»è®¾å¤å¢å 卿åååè½ã | ||
+ | |||
+ | 使¯å¦æå¯¹å®¢æ·ç«¯ççè§£ä¸æ·±å ¥ï¼ä¼äº§çä¸äºé误æè æ´æ°å¤±è´¥ï¼å¯¼è´å¨æååæ´æ°å¤±è´¥ï¼ç¨æ·æ æ³éè¿åå访é®è®¾å¤ã | ||
+ | |||
+ | å ¬äºä¸ºäºè§èååçæ´æ°æµç¨ï¼ä¿é设å¤çæ£å¸¸å·¥ä½ï¼å¯¹å¸åºä¸ä½¿ç¨å ¬äºå¨æååæ´æ°APIç设å¤è¿è¡è®¤è¯ï¼ | ||
+ | |||
+ | * ç±å ¬äºçå·¥ç¨å¸ï¼å¯¹è®¾å¤è¿è¡è®¤çï¼å ¨é¢çæµè¯ï¼ä¿è¯è®¾å¤è½å¤å¨åç§ç½ç»æ¡ä»¶ãåç§å¼å¸¸æ¡ä»¶ä¸æ£å¸¸æ´æ°åå | ||
+ | * æä¾è®¤è¯çè®¾å¤æ¸ åï¼æ¨èå ¬äºçå¹¿å¤§ç¨æ·éç¨ | ||
+ | 设å¤è®¤è¯çå ·ä½æ¹æ³ï¼è¯·åè§[[帮å©:设å¤è®¤è¯|设å¤è®¤è¯]] |