Alcance de la clave
Restricción por proyecto
El campo Proyecto (Project) limita una clave de API a un proyecto concreto:
- Cualquiera (Any) —la clave tiene acceso a todos los proyectos de la cuenta
- Un proyecto concreto —la clave trabaja solo con los datos del proyecto seleccionado
La restricción se comporta de forma distinta según el método. En los métodos de listado es un filtro: la respuesta es exitosa, pero contiene solo los datos del proyecto. En los métodos que se dirigen a una factura o billetera concreta, una solicitud por el objeto de otro proyecto se rechaza con Restricted project.
| Método | Clave restringida a un proyecto |
|---|---|
billing/balances | Datos a nivel de cuenta; la restricción no se aplica |
billing/history | Las operaciones del proyecto más las operaciones a nivel de cuenta —recargas y bonos |
billing/tariffs | Tarifa y volumen solo del proyecto de la clave |
invoices/list | Resultados solo del proyecto de la clave |
payments/list | Resultados solo del proyecto de la clave |
statistics/invoices | Se calculan solo para el proyecto de la clave |
statistics/payments | Se calculan solo sobre las facturas del proyecto de la clave |
invoices/create | El projectId de la solicitud debe coincidir con el proyecto de la clave |
invoices/cancel | La factura de otro proyecto es inaccesible |
invoices/bindPayment | La factura de otro proyecto es inaccesible |
Restricción por alcance
El alcance define qué métodos de la API puede usar la clave. Es un campo obligatorio de selección múltiple.
Una llamada a un método fuera del alcance de la clave se rechaza con Restricted scope.
Combinación de restricciones
Las restricciones por proyecto y por alcance funcionan juntas. Por ejemplo, si una clave está limitada a los métodos de facturas y vinculada a un proyecto concreto:
- Solo están disponibles los métodos de facturas
- Los datos se filtran únicamente al proyecto indicado
- Las solicitudes de pagos o estadísticas se rechazan
- Las solicitudes de datos de otros proyectos se rechazan