IT/OT/CT/DTÈÚºÏ | ÖÇÄÜÖÆ×÷Ôõô¸É£¿¹ú±êΪÄãָ·£ ¡£¨Èý£©
ÖÇÄÜÖÆ×÷Ö÷Ìâ¹ú¶È³ß¶ÈGB/T 42405.1-2023¡¶ÖÇÄÜÖÆ×÷ÀûÓû¥Áª µÚ1²¿ÃÅ£º¼¯³É¼¼ÊõÒªÇó¡·Ä¿Ç°ÒÑÕýʽ°ä²¼ ¡£
¸Ã³ß¶È½â¾öÁËÖÇÄÜÖÆ×÷¡¢¡¢¡¢¹¤Òµ»¥Áª³¡¾°ÖеÄÍò¹ú˵»°»¥·ÒëµÄÎÊÌ⣬ £¬¹¹½¨Ò»¸ö¶àÔ´Ò칹ϵͳµÄ¡°Í¬Éù·Òëƽ̨¡±£¬ £¬ÖúÁ¦ÆóҵʵÏÖÈ«ÃæµÄÖÇÄÜÖÆ×÷ ¡£
½ÓÏÂÀ´£¬ £¬¾ÍGB/T 42405.1-2023¡¶ÖÇÄÜÖÆ×÷ÀûÓû¥Áª µÚ1²¿ÃÅ£º¼¯³É¼¼ÊõÒªÇó¡·ÓйØÄÚÈݳÖÐø·ÖÏí£º
¨‹
API°ä²¼Æ½Ì¨ÒËÓÐÒÔÏÂÖ°ÄÜ£º
a)×¢²á½ÓÈ룺ÌṩAPIµÄ×¢²áÈë¿Ú£¬ £¬Í¨¹ýÊèµ¼Ò³ÃæʵÏÖÐÂAPIµÄ×¢²áÓëµ÷Õû£¬ £¬Ìṩº¬Web ServiceÓëRestfulµÄ´ó¾Ö×¢²á£¬ £¬ÇÒÖ§³ÖHttpÓëHttpsÒªÇóģʽ£»£»£»
b)ÖÜÆÚÖÎÀí£ºÊµÏÖAPI½Ó¿ÚµÄÖÜÆÚÖÎÀí£¬ £¬ÖÎÀíAPI×¢²áºó¸÷Àà״̬µÄ½ÚÖÆ£¬ £¬¶ÔAPIʵÏÖ´´½¨¡¢¡¢¡¢°ä²¼¡¢¡¢¡¢¹ýÆÚ¡¢¡¢¡¢ÍËÒ۵ĽÚÖƼ°±£»£»£»¤£»£»£»
c)¶©ÔÄÖÎÀí£º²é¿´µ±Ç°´¦Óڰ䲼״̬µÄAPI£¬ £¬±»¶©ÔĵÄʹÓÃÇé¿ö£¬ £¬ÓÉ˶©ÔÄÁËÀ´×Ô˵ÄAPI¾ßÌåÐÅÏ¢£¬ £¬Äܹ»ÓÉÖÎÀíÔ±¶ÔÒѶ©ÔĵÄAPI½øÐйýÎʽâ³ý¶©ÔÄ£»£»£»
d)°æ±¾ÖÎÀí£º¶ÔÒÑ×¢²áµÄͳһ×éÖ¯°ä²¼µÄÒ»Ñù½Ó¿ÚµÄAPIʵÏÖ°æ±¾½ÚÖÆ£»£»£»
e)×ÊÁÏÖÎÀí£º¶ÔÒÑ×¢²á°ä²¼³É¹¦µÄAPI£¬ £¬Ìṩ×ÊÁÏÖÎÀíµÄÊØ»¤²Ù×÷£¬ £¬ÃèÊöAPIµÄʹÓÃÓë½éÉܵľßÌå×¢Ã÷£»£»£»
f)½Ó¿Ú²âÊÔ£º¾ß±¸Ê¹ÓÃ״̬ϵÄAPI²âÊÔÄÜÁ¦£¬ £¬ÌáÔç·¢ÏÖAPI²âÊÔŲÓõÄʹÓÃÇé¿ö£»£»£»
g)½Ó¿ÚĿ¼£º³öÏÖËùÓÐ״̬ϵÄAPI½Ó¿ÚĿ¼Çåµ¥ ¡£
»ù´¡ÖÎÀíÒËÓÐÒÔÏÂÖ°ÄÜ£º
a)ÕË»§×¢²á£ºÌṩÐÂÓû§µÇ¼ÇÈë¿Ú£¬ £¬Â¼ÈëÆóÒµ»òСÎÒÕË»§ÐÅÏ¢£»£»£»
b)ÐÅÏ¢Åú¸Ä£º³ýÕ˺ÅÍâµÄ£¬ £¬ÆóÒµ»òСÎÒÐÅÏ¢ÓëÃÜÂëµÄµ÷Õû£»£»£»
c)·ÖÅäȨÏÞ£ºÓÉÖÎÀíÔ±µ÷»»»òÅäÖÃÓû§¶ÔAPI²Ù×÷µÄȨÏÞ£¬ £¬API²Ù×÷µÄȨÏÞÔ̺¬£¨¶©ÔÄ¡¢¡¢¡¢°ä²¼¡¢¡¢¡¢¶©ÔÄ/°ä²¼£©×é³É ¡£
Õë¶Ô·ÖÆçAPI·þÎñµÄ¸ö±ð²î¾à£¬ £¬¶ÔÆäAPI·þÎñÔÚʹÓÃÏ޶ȵÄÕ½ÊõÉÏ£¬ £¬ÌåÏÖ¶ÔÆä½øÐÐÁ÷Á¿µÄ½Ó¼û½ÚÖÆÓëÁ÷Á¿µÄÖÎÀíÖ°ÄÜ£¬ £¬²¢Ìṩ֧³Ö¸ß²¢·¢¸ß½Ó¼ûÁ¿APIÍø¹Ø·¨Ê½ÔÚÉϲãÁ÷Á¿µÄ·À»¤ÄÜÁ¦ ¡£
ÖÎÀíËùÓзþÎñÒªÇ󷽵ݲȫŲÓÃÐÐΪ£¬ £¬°²È«ÒÔ¼°½Ó¼ûÁîÅÆÓйصIJÙ×÷ ¡£Gateway ÓëÃÜÔ¿ÏνÓÀ´²é³¶©ÔĺÍŲÓÃAPIµÄOAuth2ÁîÅƵÄÊÇ·ñÓÐЧÐÔ ¡£
¶ÔAPI·þÎñŲÓúóÖ´Ðй涨ÖÎÀí½ÚÖƵÄÐÐΪ£¬ £¬Ã¿¸öAPI·þÎñ¶¼³öȱʡÖнéÁ÷£¬ £¬ÔÚÿ¸öAPI±»Å²ÓÃʱִÐÐ ¡£Ê¹ÓÃÖнéÁ÷µÄ¼ÓÇ¿¹æ¶¨µÄ¶¨ÖÆ»¯ÄÜÁ¦ ¡£
ÌṩHttp»òHttpsÍ·²ÎÊýʵÏÖ´«ÊäµÄ¶¯Ì¬Êý×ÖÇ©Ö¤ÈÏÖ¤ ¡£ÔÚÌáÒéÒªÇóʱ£¬ £¬ÓÉ·þÎñÒªÇó·½ÌṩÁîÅÆ£¬ £¬¶ÔÓÚÁîÅÆÖÎÀíÓÉÌáÒé·½×ÔÐÐÊØ»¤ ¡£
¡ø CPSÈÚͨ»¥Áª×ÜÏ߼ܹ¹
APIÉ̵êƽ̨ÒËÓÐÒÔÏÂÖ°ÄÜ£º
a)½Ó¿ÚËÑË÷£ºÆ¾¾Ý¿Í»§µÄ¶ÔÒµÎñµÄÒªÇó£¬ £¬½øÐÐÓйØÒµÎñ½Ó¿ÚµÄËÑË÷É¸Ñ ¡£»£»£»
b)½Ó¿ÚÍƼö£º¶Ô¹Ì¶¨ÖÜÆÚÁìÓòÄÚ£¨Ò»ÖÜ»òÒ»¸öÔ£©Ð°䲼µÄ½Ó¿Ú´ÍÓëÌáÐÑ£¬ £¬ÍƼöä¯ÀÀAPIÉ̵êµÄÓû§Ê¹Ó㻣»£»
c)¶©ÔĽӿڣºËùÓÐÔڰ䲼״̬ϵÄAPI½Ó»°±úÏÖ¶©ÔÄ»ò½â³ý¶©ÔĵÄË«Ïò²Ù×÷£¬ £¬¶ÔÒѶ©ÔĵĽӿڿɽâ³ý¶©ÔÄ£»£»£»
d)¶©ÔÄĿ¼£º²é¿´µ±Ç°Òѱ»¶©ÔĵÄAPI½Ó¿ÚÌõ¿î£¬ £¬Í¨¹ýɸѡǰÌá²éÎÊÒѶ©ÔĵÄAPI½Ó¿Ú£»£»£»
e)×ÊÁϲéÔÄ£ºÌṩAPI½Ó¿ÚµÄÓйØ×ÊÁϲéÔÄ£¬ £¬»ñÈ¡API½Ó¿ÚµÄʹÓü°½éÉÜÐÅÏ¢£»£»£»
f)ÔÚÏßÊÔÓãºÔÚÉ̵êÖгöÏֵķþÎñÌṩ·½µÄAPI¾ß±¸ÔÚÏßÊÔÓòâÊÔµÄÄÜÁ¦£¬ £¬ÊìϤAPI½Ó¿ÚµÄʹÓÃÒªÇ󣻣»£»
g)·þÎñÆÀ¼Û£ºÊ¢¿ª¶ÔAPI·þÎñʹÓõÄÐĵû¥»»£¬ £¬¶ÔAPI·þÎñµÄÆÀ¼Û×ÛºÏÆÀ¼Û£¬ £¬Æ¾¾ÝÆÀ¶¨´ò·ÖʵÏÖ×ۺϿ¼ÆÀAPI·þÎñÖÊÁ¿ ¡£
APIÍø¹ØÒËÓÐÒÔÏÂÖ°ÄÜ£º
a)Êý¾Ý´«Ê䣺¾ß±¸Êý¾Ý´«ÊäʵÏÖAPI·þÎñÐÅÏ¢»¥»»µÄÄÜÁ¦£»£»£»
b)·þÎñ·ÓÉ£º¶ÔAPI·þÎñÌáÒéŲÓÃÒªÇó£¬ £¬²¢Æ¾¾Ý¶©ÔĵÄAPI·þÎñ£¬ £¬×Ô¶¯Ñ°Ö·ÕÒµ½API·þÎñÌṩ·½£¬ £¬Í¨¹ý´úÀíµÄ·½Ê½Å²ÓÃAPI·þÎñ£»£»£»
c)·þÎñ±àÅÅ£ºÊµÏÖ·þÎñµÄÍÏקʽ±àÅÅ¡¢¡¢¡¢Ìṩ¿ÉÊÓ»¯µÄ¹¤×÷Á÷±àÅÅÄÜÁ¦£»£»£»
d)¹æ¶¨Å²ÓãºÀûÓÃÖнéÐÂÎÅÁ÷µÄÄÜÁ¦£¬ £¬¶Ô·þÎñŲÓõÄÊý¾Ý½øÐж¨ÖÆ»¯´¦Ö㻣»£»
e)ÈÏÖ¤ÊÚȨ£ºÊµÏÖÒªÇó·½API·þÎñµÄŲÓýÚÖÆ£¬ £¬Õƹܲé³API·þÎñµÄŲÓÃÈÏÖ¤£»£»£»
f)·þÎñÈ۶ϣºÆ¾¾ÝÑ¡ÔñµÄAPIÈ۶ϼ¶±ð£¬ £¬¶ÔAPI·þÎñÔÚ¹¦·òÁìÓòÄÚÒ»Ñù·þÎñŲÓôÎÊýÏÞ¶ÈÄÜÁ¦£¬ £¬³¬³öÈ۶ϴÎÊý½«Ê§È¥Å²ÓÃÄÜÁ¦£»£»£»
g)Á÷Á¿½ÚÖÆ£º¾ß±¸½Ó¼ûÁ÷Á¿ÍÆË㣬 £¬»ùÓÚÁ÷Á¿ÍÆËã·ÖÎö½øÐÐÏÞÁ÷£¬ £¬½ç˵¶àÖÖÏÞÁ÷¹æ¶¨£»£»£»
h)ÊÇ·ÇÃûµ¥£ºÊµÏÖ·þÎñÆ÷Ö®¼äµÄ»¥½Ó¼ûÏ޶ȣ¬ £¬Í¨¹ýÊÇ·ÇÃûµ¥×¢²á½Ó¼ûÊÜ¿Ø·þÎñÆ÷£¬ £¬Ö´Ðв¢½âÎöÊÇ·ÇÃûµ¥Ï޶ȽӼû ¡£
¡ø ºÍ̸·Ö²ãת»»»¥ÁªÄ£ÐÍ
API¼à¿ØÒËÓÐÒÔÏÂÖ°ÄÜ£º
a)»úÄܼà¿Ø£ºÊµÏÖ·þÎñÆ÷ÔÚÔËÐÐ״̬ϸ÷ÀàÓ²¼þ×ÊÔ´£¨CPU¡¢¡¢¡¢ÄÚ´æ¡¢¡¢¡¢´æ´¢¡¢¡¢¡¢´ø¿í£©µÄ¼à¿Ø£¬ £¬¶Ôÿ´ÎŲÓÃAPI·þÎñÒªÇóÏìÓ¦µÄ»úÄܽøÐÐʱ³¤¼à¿Ø£»£»£»
b)Òì³£¸æ¾¯£º¶ÔAPI·þÎñÔÚŲÓùý³ÌÖгöÏÖµÄÒì³£½øÐи澯ÊÂÎñ֪ͨ£¬ £¬Í³¼ÆAPI·þÎñ¸æ¾¯ÊÂÎñµÄÌõ¿î£»£»£»
c)ÈÕÖ¾·ÖÎö£º¾ß±¸¼Í¼ÿ´ÎŲÓÃAPI·þÎñÒªÇóÏìÓ¦ÄÜÁ¦£¬ £¬½«²Ù×÷Á÷Ë®¼Í¼ÐÅϢдÈëÈÕÖ¾ÎļþÖеÄÖ°ÄÜ£»£»£»
d)ÒÀÀµ¹Øϵ·ÖÎö£º¾ß±¸API·þÎñ¼äµÄ²ã¼¶¡¢¡¢¡¢Á£¶È£¬ £¬Ï໥¼äŲÓùØϵµÄÒÀÀµ¹ØϵͼÆ×»ã×ÜÄÜÁ¦£»£»£»
e)½Ó¿Úͳ¼Æ£º¶ÔÒѽÓÈëµÄAPI·þÎñÔÚ¶àÖÖ״̬ϵÄÊýÁ¿Í³¼Æ£»£»£»
f)ʹÓôÎÊý£º¶ÔÒÑʹÓùýµÄAPI·þÎñ£¬ £¬ÔÚÿ´ÎŲÓÃÇé¿öÏ£¬ £¬»ã×ÜʹÓÃAPI·þÎñ´ÎÊýÄÜÁ¦ ¡£
