feat(api): Add integration endpoint to project key serializer

[AbhiPrasad]

In Relay we've moved toward an integration abstraction on endpoints to represent trace and log (and in the future metric) drain endpoints. For example, our current support for OTLP, or future support for Vercel/Netlify Log Drains.

https://github.com/getsentry/relay/blob/b97e972470adb15ac5a479375752b2ede6adfd63/relay-server/src/endpoints/mod.rs#L84-L91

This PR adds that integration endpoint to the project key serializer. This will look something like so: https://o4504765715316736.ingest.sentry.io/api/4505281256090153/integration/.

By default something like /api/4505281256090153/integration/ will actually do nothing, as you'll need to provide further parameters to specify the integration you're using. For example /api/4505281256090153/integration/vercel/logs for the vercel log drain endpoint, or /api/4505281256090153/integration/vercel/logs.

From the integration endpoint, we can construct the rest of the endpoints easily. This does mean that the ProjectKeySerializer becomes less of a source of truth, but I think the increased flexibility means this is a good change.

[seer-by-sentry]

Bug: The integration_endpoint method is missing the @property decorator, causing it to return a method object instead of a string URL, which breaks API serialization.
_{(Severity: Critical 0.85 | Confidence: 1.00)}

🔍 Detailed Analysis

The integration_endpoint method in the ProjectKey model is missing the @property decorator. Unlike other similar methods in the class, this causes it to return a bound method object instead of a string URL. When the ProjectKeySerializer serializes a ProjectKey instance, it attempts to include obj.integration_endpoint. This will raise a TypeError because a method object is not JSON serializable, causing the /api/0/projects/{organization}/{project}/keys/ endpoint to fail.

💡 Suggested Fix

Add the @property decorator to the integration_endpoint method in the ProjectKey model. This will ensure it returns a string URL, consistent with other endpoint properties in the class, and can be correctly serialized.

🤖 Prompt for AI Agent

Fix this bug. In src/sentry/models/projectkey.py at lines 268-271: The
`integration_endpoint` method in the `ProjectKey` model is missing the `@property`
decorator. Unlike other similar methods in the class, this causes it to return a bound
method object instead of a string URL. When the `ProjectKeySerializer` serializes a
`ProjectKey` instance, it attempts to include `obj.integration_endpoint`. This will
raise a `TypeError` because a method object is not JSON serializable, causing the
`/api/0/projects/{organization}/{project}/keys/` endpoint to fail.

_{Did we get this right? 👍 / 👎 to inform future reviews.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@             Coverage Diff             @@
##           master   #101999      +/-   ##
===========================================
+ Coverage   80.97%    80.99%   +0.01%     
===========================================
  Files        8730      8730              
  Lines      388499    389176     +677     
  Branches    24632     24632              
===========================================
+ Hits       314593    315195     +602     
- Misses      73546     73621      +75     
  Partials      360       360              

[AbhiPrasad]

Alright I decided I'm not going to go with this. Instead we'll expose every endpoint individually from the project key serializer. Given we have a tabbed approach here (#102010) I think this makes more sense.

If we need to refactor it, we can always easily do this in the future.