Interfaz API del juego para acceder al conocimiento de principiantes
Definición de API
Para muchos productos o solicitantes de empleo, interfaz API es un término técnico en el campo del producto y la I+D. Es posible que haya encontrado el concepto de interfaz API en artículos o. PRD.
De hecho, la aplicación de interfaces ha sido muy extensa y madura. Este concepto está activo principalmente en la conexión y acoplamiento de varios sistemas dentro de la empresa, así como en la cooperación entre empresas. Si puede leer este artículo con atención, creo que tendrá una comprensión más profunda de la interfaz API, incluso mejor que el 90% de los principiantes y solicitantes de empleo.
Contenido de este artículo:
¿Qué es la interfaz API API del juego?
¿Por qué necesitamos la interfaz API API del juego?
El núcleo de la interfaz API API del juego
Utilizamos una fórmula matemática común para comprender la API, como y = x +2. Cuando x=2, y=4, ¿verdad?
En ese momento, llamamos y=x+2 como interfaz, x=2 como parámetro e y=4 como resultado de retorno, por lo que la función de esta interfaz es sumar 2 al número que ingresamos (Nota: puede encontrarlo aquí. La interfaz en sí es lógica).
A modo de analogía, entendamos un escenario común. Por ejemplo, existe una interfaz que puede convertir la longitud y la latitud en ciudades. Cuando entro en longitud 55 y latitud 88, la interfaz me dirá el resultado a través de su propia operación lógica: Hangzhou.
De esta manera podrás entender claramente la explicación oficial de la Enciclopedia Baidu. Una interfaz es una lógica funcional predefinida, algo que otros sistemas solicitan y luego devuelven resultados.
Antecedentes: Nuestro sistema empresarial involucra muchos aspectos. Si una empresa o un sistema necesita hacer todo el negocio, entonces la carga de trabajo será demasiada, ¿verdad? Y si otros sistemas o empresas tienen una mejor lógica operativa, entonces podemos considerar el uso de interfaces para el desarrollo al diseñar funciones.
Requisitos principales: el uso de interfaces existentes puede reducir los costos de desarrollo y acortar los costos de desarrollo.
Por ejemplo: Por ejemplo, soy una aplicación para jugar y ahora necesito mostrar las funciones del juego en mi página. Para nuestra empresa, el nuevo costo de desarrollo es demasiado alto y podemos acceder a la API proporcionada por la plataforma abierta del proveedor de la interfaz NGAPI. En este caso, solo necesitamos solicitar una cuenta de interfaz API, implementar y llamar a la API de interfaz NGAPI, y luego podremos iniciar rápidamente una plataforma de juegos enriquecida en nuestra página.
Para los principiantes, la documentación de la API puede resultar confusa a primera vista: dónde buscar, cómo buscar y cuál es el problema en cuestión.
De hecho, los gerentes de producto deberían prestar más atención a qué tipo de servicios de interfaz API puede proporcionar esta empresa. Por ejemplo, sé que Amap puede proporcionar API de mapas y API de planificación de rutas, para que podamos llamar a sus servicios o referencias en funciones y trabajos de diseño.
Así que los principiantes en el producto no necesitan preocuparse demasiado si no lo entienden. Lo comprenderá más profundamente en trabajos futuros, porque comprender no es complicado. Los siguientes son los puntos centrales de la interfaz API. Todos los documentos de descripción son inseparables de estos cinco puntos centrales.
La siguiente descripción toma como ejemplo la plataforma abierta WeChat. Hay direcciones de varias plataformas abiertas al final del artículo. Puede consultarlas cuando tenga tiempo. Bien, ahora preparemos una escena antes de que sea demasiado tarde.
Ahora tenemos una APLICACIÓN que requiere que los usuarios ajusten la API de pago de WeChat para completar la compra. Ingrese automáticamente a esta escena y considérese un gerente de producto.
1. Dirección de la interfaz
Ahora, cuando el usuario hace clic para pagar, ¡debemos decirle a WeChat que queremos ajustar su cajero! ¿Pero a quién? Esto requiere una dirección de interfaz, que equivale a transmitir los datos especificados al enlace en WeChat.
La dirección del enlace no es una página que entendamos. Puedes entenderla como un número de teléfono. Los blancos deberían cambiar este concepto.
En este punto podemos ver que el documento de la interfaz nos dice que el enlace es el siguiente, por lo que ahora hemos marcado WeChat.
2. Solicitar parámetros (mensaje)
Ahora debemos decirle a WeChat que desea llamar al cajero. Luego debemos escribirlo. El mensaje generado se llama mensaje, lo que significa qué le quiere decir a esta interfaz. Equivalente a la entrada x=2 de la función anterior.
Generalmente, el formato y contenido del mensaje se especifican en el documento de la interfaz. Los siguientes son los requisitos de mensajes para llamar al cajero en la plataforma abierta WeChat.
Veamos primero los dos primeros parámetros. Estás hablando con WeChat ahora. ¿Debería decírselo a WeChat primero? ¿Quién eres? La documentación de WeChat aquí le indica que debe utilizar el ID de la aplicación + el número de comerciante para determinar su identidad. ¿Qué quiere decir esto?
Por ejemplo, si usted es un comerciante y hay tres aplicaciones A, B y C a continuación, WeChat necesita saber qué comerciante es usted y qué aplicación a continuación debe usar el cajero. Esto es muy importante. Luego, WeChat enviará el dinero recibido a la cuenta correspondiente y recopilará estadísticas.
Entonces escribamos estas dos frases en el mensaje:
& ltappid & gtwx 2421b 1c 4370 EC 43 b </appid & gt;(Mi aplicación El ID es WX2421.. .)
& ltmch _ id & gt10000100 & lt;/mch _ id & gt; (Mi número de comerciante es 10000...)
Bien, ahora que WeChat sabe quién es usted Entonces tienes que decirle a WeChat cuánto necesitas WeChat Pay para ayudarte a cobrar el dinero, ¿verdad? Aquí se definen la moneda y el monto total, es decir, en qué moneda se cobra y cuánto se cobra.
Como puede ver aquí, la moneda solicitada está escrita como No, lo que significa que no necesita decirle a WeChat cuál es la moneda de pago, porque luego comentó que la predeterminada era RMB.
Bien, anotemos dos datos.
& ltfree_type>CNY</free _type>(Quiero aceptar RMB)
& lttotal_fee>1</total_fee>(Quiero recargar 1 yuan)
Está bien , dado que WeChat sabe quién es usted y cuánto desea cobrar, WeChat Pay debería informarle el resultado del pago, porque necesita saber que el usuario ha pagado correctamente. Sólo entonces podrá continuar entregando bienes y servicios. etc. Entonces aquí usamos la dirección de notificación, que es para decirle a WeChat adónde irá para informarle el resultado del pago después de finalizar la transacción. Luego escribamos la dirección:
<notify_url>/pub_v2/pay/notify.v2.PHP</notify_URL>
Devolver resultado
WeChat Pay acaba de ir a cobrar el dinero, y ahora quiere decirnos el resultado en la dirección de notificación que dejamos. Sólo hay dos resultados: ¿cobro exitoso? ¿La recogida no tuvo éxito?
(1) Éxito
Todo fue muy bien. Ahora el usuario pagó el dinero con éxito. WeChat también nos contó la noticia del éxito. También nos dio alguna información sobre el pago del usuario. .
Entonces esta es la información que WeChat Pay nos proporciona después de que el pago se haya cobrado correctamente.
APPID de aplicación, ID de comerciante: le indica qué APPID utilicé para debitar con éxito transacciones de qué comerciante.
Resultados empresariales: éxito o fracaso
(2) Fracaso
En el diseño de productos, muchas veces nos centramos en el fracaso. Cuando falla el cobro del pago, WeChat también le informará el motivo del error. La siguiente imagen es fácil de entender. Hay muchas razones para el fracaso. Al diseñar, a menudo necesitamos analizar los motivos de cada falla y diseñar páginas y mensajes de usuario para cada motivo para asegurarnos de que los usuarios puedan entenderlo.
Lo anterior es una comprensión de los métodos operativos básicos de la interfaz API. Continuaré actualizando algunos elementos clave más profundos y detallados de la interfaz API, como el modo de solicitud/firma/cifrado y descifrado, etc.