๐Ÿ“˜

API Docs - Choriper

Automatic documentation for public project APIs

Automatic documentation for public APIs used across the Choriper project systems. This page is generated automatically from the public endpoint files.

You can support the project in USD through Ko-fi, or in BRL through the official RIP-BF store.

๐Ÿ“ Folder: /endpoints/ ๐Ÿงฉ Files: .js ๐Ÿ“Œ Endpoints: 15
๐Ÿ”Œ

EA Connect AcceptFriendInvitation

Accepts a pending EA friend invitation from another player.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 3 fields
action
Required. Must be AcceptFriendInvitation.
api_token
Required. RIP-BF API/session token for the authenticated user.
friend_pd
Required. Numeric PD of the player who sent the invitation.
๐Ÿ“ฆ Response fields 5 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
friend_pd
PD of the accepted friend, when returned by the API.
friend_data
Friend profile data, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=AcceptFriendInvitation&api_token=SEU_TOKEN_RIP_AQUI&friend_pd=PD_DO_JOGADOR"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect CancelFriendInvitation

Cancels an outgoing EA friend invitation already sent to another player.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 3 fields
action
Required. Must be CancelFriendInvitation.
api_token
Required. RIP-BF API/session token for the authenticated user.
ea_pd
Required. Target player PD for the outgoing invitation to cancel.
๐Ÿ“ฆ Response fields 4 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
ea_pd
Target player PD, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=CancelFriendInvitation&api_token=SEU_TOKEN_RIP_AQUI&ea_pd=PD_DO_ALVO"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect GetPersonas

Returns personas for the EA account linked to the RIP-BF token, including names and namespace information.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 2 fields
action
Required. Must be GetPersonas.
api_token
Required. RIP-BF API/session token for the authenticated user.
๐Ÿ“ฆ Response fields 10 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
me
EA account object, when returned by the GraphQL response.
id
EA account ID / Nucleus ID.
personas
Array of personas linked to the EA account.
psd
Persona ID / PSD for a persona.
displayName
Persona display name.
namespaceName
Persona namespace, when available.
externalLoginRequired
Boolean flag from EA persona data, when available.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=GetPersonas&api_token=SEU_TOKEN_RIP_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect get-me-avatar

Returns avatar, names and owned games for the EA account linked to the RIP-BF token.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 2 fields
action
Required. Must be get-me-avatar.
api_token
Required. RIP-BF API/session token for the authenticated user.
๐Ÿ“ฆ Response fields 9 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
displayName
EA display name, when available.
nickname
EA social nickname, when available.
avatarUrl
Avatar image URL, when available.
games
Owned games array, when returned by the backend.
ea_id
EA account / Nucleus ID, when returned by the backend.
ea_pd
EA PD ID, when returned by the backend.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=get-me-avatar&api_token=SEU_TOKEN_RIP_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect GetMyFriendsBypd_id

Checks whether a specific PD is already a friend of the current authenticated EA account.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 3 fields
action
Required. Must be GetMyFriendsBypd_id.
api_token
Required. RIP-BF API/session token for the authenticated user.
ea_pd
Required. Player PD to check against the current friend list.
๐Ÿ“ฆ Response fields 5 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
is_friend
Boolean indicating whether the player is already a friend.
friend_data
Matched friend profile data, when found.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=GetMyFriendsBypd_id&api_token=SEU_TOKEN_RIP_AQUI&ea_pd=PD_DO_JOGADOR"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect GetMyFriends

Returns the friend list for the EA account linked to the RIP-BF token.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 2 fields
action
Required. Must be GetMyFriends.
api_token
Required. RIP-BF API/session token for the authenticated user.
๐Ÿ“ฆ Response fields 6 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
friends
Array of friend profile objects, when returned by the API.
items
Friend list items, depending on backend response format.
totalCount
Total friend count, when returned by the EA GraphQL response.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=GetMyFriends&api_token=SEU_TOKEN_RIP_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect GetPlayerFriendsByPd

Lists the public friends of a specific EA player using that player PD.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 5 fields
action
Required. Must be GetPlayerFriendsByPd.
api_token
Required. RIP-BF API/session token for the authenticated user.
ea_pd
Required. Target player PD whose friends should be listed.
offset
Optional. Pagination offset, when supported by the backend.
limit
Optional. Pagination limit, when supported by the backend.
๐Ÿ“ฆ Response fields 6 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
friends
Array of player friend profile objects, when returned by the API.
items
Friend list items, depending on backend response format.
totalCount
Total count, when returned by the EA GraphQL response.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=GetPlayerFriendsByPd&api_token=SEU_TOKEN_RIP_AQUI&ea_pd=PD_DO_JOGADOR"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect RejectFriendInvitation

Rejects a pending EA friend invitation from another player.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • May require a Cloudflare Turnstile cf_token depending on backend protection.
  • Do not expose api_token, cf_token or private account data publicly.
๐Ÿงพ Parameters 4 fields
action
Required. Must be RejectFriendInvitation.
api_token
Required. RIP-BF API/session token for the authenticated user.
friend_pd
Required. Numeric PD of the player who sent the invitation.
cf_token
Optional or required depending on backend protection. Cloudflare Turnstile token.
๐Ÿ“ฆ Response fields 4 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
friend_pd
PD of the rejected invitation sender, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=RejectFriendInvitation&api_token=SEU_TOKEN_RIP_AQUI&friend_pd=PD_DO_JOGADOR&cf_token=SEU_TURNSTILE_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect RemoveFriendByPd

Removes an EA friend using the friend player PD.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • May require a Cloudflare Turnstile cf_token depending on backend protection.
  • This action modifies the authenticated EA social account.
  • Do not expose api_token, cf_token or private account data publicly.
๐Ÿงพ Parameters 4 fields
action
Required. Must be RemoveFriendByPd.
api_token
Required. RIP-BF API/session token for the authenticated user.
ea_pd
Required. Friend PD to remove.
cf_token
Optional or required depending on backend protection. Cloudflare Turnstile token.
๐Ÿ“ฆ Response fields 4 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
ea_pd
Removed friend PD, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=RemoveFriendByPd&api_token=SEU_TOKEN_RIP_AQUI&ea_pd=PD_DO_AMIGO&cf_token=SEU_TURNSTILE_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect SearchPlayer

Searches EA players by name and returns profile identifiers, display names, avatar data and mutual friend information when available.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 6 fields
action
Required. Must be SearchPlayer.
api_token
Required. RIP-BF API/session token for the authenticated user.
searchText
Required. Player name or partial player name to search. Example: jnnavegador.
pageNumber
Optional. Page number. Default is 1.
pageSize
Optional. Page size. Default is 20. Maximum may be limited by the backend.
mutualFriendsEnabled
Optional. Boolean. When true, asks EA for mutual friend information when supported.
๐Ÿ“ฆ Response fields 9 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
items
Array of matched player objects, when returned by the EA GraphQL response.
displayName
Matched player display name.
pd
EA account PD / user ID, when returned by EA.
psd
Persona ID, when returned by EA.
avatar
Avatar object or avatar URL, depending on response format.
mutualFriends
Mutual friends count or object, when available.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=SearchPlayer&api_token=SEU_TOKEN_RIP_AQUI&searchText=jnnavegador&pageNumber=1&pageSize=20"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect SelfNicknameUpdate

Updates the authenticated EA account social nickname.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Requires or may require a valid Cloudflare Turnstile cf_token.
  • The nickname may be rejected by EA formatting or availability rules.
  • This action modifies the authenticated EA account.
๐Ÿงพ Parameters 4 fields
action
Required. Must be SelfNicknameUpdate.
api_token
Required. RIP-BF API/session token for the authenticated user.
new_nickname
Required. New nickname to set on the authenticated EA account.
cf_token
Required or recommended depending on backend protection. Cloudflare Turnstile token.
๐Ÿ“ฆ Response fields 5 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
nickname
Updated nickname, when returned by the API.
profile
Updated account profile data, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=SelfNicknameUpdate&api_token=SEU_TOKEN_RIP_AQUI&new_nickname=NOVO_NICK&cf_token=SEU_TURNSTILE_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect SendFriendInvitation

Sends a friend invitation to another EA player using the target player PD.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Requires or may require a valid Cloudflare Turnstile cf_token.
  • The backend should block sending an invitation to yourself.
  • Do not expose api_token, cf_token or private account data publicly.
๐Ÿงพ Parameters 4 fields
action
Required. Must be SendFriendInvitation.
api_token
Required. RIP-BF API/session token for the authenticated user.
ea_pd
Required. Target player PD / persistent EA identifier.
cf_token
Required or recommended depending on backend protection. Cloudflare Turnstile token.
๐Ÿ“ฆ Response fields 5 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
invite
Invitation result data, when returned by the API.
target_pd
Target player PD, when returned by the API.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=SendFriendInvitation&api_token=SEU_TOKEN_RIP_AQUI&ea_pd=PD_DO_AMIGO&cf_token=SEU_TURNSTILE_AQUI"
โ–ถ Test POST endpoint
๐Ÿ”Œ

EA Connect user-data

Proxies the EA Drop API user-data route and returns detailed information about the EA account linked to the RIP-BF token.

POST

โš ๏ธ Warnings

  • Requires a valid RIP-BF api_token linked to an EA account.
  • Do not expose api_token, cf_token, cookies or private account data publicly.
๐Ÿงพ Parameters 3 fields
action
Required. Must be user-data.
api_token
Required. RIP-BF API/session token for the authenticated user.
locale
Optional. Response locale. Default is en. Examples: pt-br, en, es, fr, de, ja, ko.
๐Ÿ“ฆ Response fields 6 fields
success
Boolean indicating whether the operation succeeded, when returned by the API.
error
Boolean indicating whether the request failed, when returned by the API.
message
Request status or error message.
response
EA user-data response payload.
raw
Raw response body when the upstream response is not JSON.
locale
Locale used for the request, when returned by the backend.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/login/account/ea-connect/" -H "Content-Type: application/x-www-form-urlencoded" -d "action=user-data&api_token=SEU_TOKEN_RIP_AQUI&locale=pt-br"
โ–ถ Test POST endpoint
๐Ÿ”Œ

getTokenInfo

Returns information about the currently authenticated RIP-BF user. This endpoint requires an active logged-in session and reads the user's session cookies automatically.

POST

โš ๏ธ Warnings

  • This endpoint requires an active logged-in session.
  • A plain curl request without valid cookies will usually return unauthenticated.
  • Do not expose private session cookies or returned tokens publicly.
๐Ÿงพ Parameters 2 fields
session
Required indirectly. The user must be logged in on RIP-BF. The endpoint uses the active browser/session cookies.
body
No body is required for the default session check.
๐Ÿ“ฆ Response fields 9 fields
error
Boolean indicating whether the request failed.
success
Boolean indicating whether the authenticated session is valid, when returned by the API.
message
Request status message.
ea_id
EA account / Nucleus ID associated with the logged-in user, when available.
ea_pd
EA PD ID associated with the logged-in user, when available.
user_id
Internal RIP-BF user ID, when available.
username
Logged-in user name or display name, when available.
permissions
User permissions array or permission data, when available.
access_token
Session/API token returned by the endpoint, when available.

๐Ÿงช Example

curl -X POST "https://rip-bf.com/api/token/"
โ–ถ Test POST endpoint
๐Ÿ”Œ

getOwnedGameAchievements

Returns a player's owned-game achievements for a specific game. The response keeps a GraphQL-like structure and includes achievement objects with names, descriptions, dates, award counts and image arrays.

GET

๐Ÿงญ Usage type

Use this to fetch Battlefield V achievements using the game shortcut.

โš ๏ธ Warnings

  • You must provide id.
  • Use only one game selector: game OR gameSlug.
  • gameSlug should be the exact tag from the player profile when used.
  • The response keeps a GraphQL-like structure, unlike the normalized gameAchievements endpoint.
๐Ÿงพ Parameters 5 fields
id
Required. Player PSD / userId. Example: 1007917900222
game
Optional. Game shortcut. Supported values include bfv, bf1 and bf6. Use this OR gameSlug.
gameSlug
Optional. Exact game tag from the player profile. Example: BFV or BF6 BETA. Use this OR game.
show-hidden
Optional. Boolean. Default: true. When true, includes hidden achievements.
locale
Optional. Response language. Default: pt-br. Examples: en-us, es-es, pt-br.
๐Ÿ“ฆ Response fields 9 fields
data
Root GraphQL-like response object.
achievements
Array of achievement groups returned by the upstream response.
id
Achievement ID.
name
Achievement name.
description
Achievement description.
awardCount
Achievement award count / value.
date
Unlock date or related achievement date, when available.
images
Array of achievement image objects. The icon is usually images[1].path with fallback to images[0].path.
path
Image path inside an image object.

๐Ÿงช Example

curl -X GET "https://rip-bf.com/api/player-global/ownedGameAchievements/?id=1007917900222&game=bfv&show-hidden=true&locale=en-us"
โ–ถ Test GET endpoint